Metadata-Version: 2.4
Name: medcreatorguard
Version: 0.1.0
Summary: AI safety toolkit for clinicians and health content creators
License: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: openai>=1.30.0
Requires-Dist: pydantic>=2.6.0
Requires-Dist: typer>=0.12.0
Requires-Dist: rich>=13.7.0
Requires-Dist: httpx>=0.27.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
Requires-Dist: pytest-mock>=3.12.0; extra == "dev"
Dynamic: license-file

# MedCreatorGuard

**AI safety toolkit for clinicians and health content creators**

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Python 3.10+](https://img.shields.io/badge/Python-3.10+-blue.svg)](https://python.org)

> 의사이자 AI creator의 관점에서 설계한 의료 콘텐츠 안전성 검토 오픈소스 도구.
>
> ---
>
> ## What is this?
>
> MedCreatorGuard is an open-source AI toolkit that helps clinicians and health creators review medical content for factual accuracy, evidence quality, and patient safety **before publishing**.
>
> SNS에 올라오는 건강 콘텐츠 중 많은 부분이:
> - 효과를 과장하거나 ("완치됩니다", "모든 사람에게 효과")
> - - 근거 없는 주장을 하거나 ("독소 배출", "간 해독")
>   - - 전문 의료를 불필요하게 여기게 만들거나 ("병원 안 가도 됩니다")
>    
>     - MedCreatorGuard는 이런 문제를 자동으로 감지하고, 더 안전한 표현으로 수정을 제안합니다.
>    
>     - ---
>
> ## Features
>
> - **Rule-based scan** — API 호출 없이 위험 패턴 즉시 감지 (한국어 + 영어)
> - - **LLM analysis** — GPT-4o를 이용해 의료 주장 추출, 근거 등급 평가, 안전한 재작성 제안
>   - - **CLI tool** — 터미널에서 바로 사용 가능 (`medguard check`, `medguard rewrite`)
>     - - **Paper-to-post** — 연구 논문 초록 → 안전한 SNS 포스트 자동 변환
>      
>       - ---
>
> ## Installation
>
> ### Option 1: PyPI (권장)
> ```bash
> pip install medcreatorguard
> ```
>
> ### Option 2: GitHub에서 직접 설치
> ```bash
> git clone https://github.com/aimekoreaofficial/MedCreatorGuard.git
> cd MedCreatorGuard
> pip install -e .
> ```
>
> ### OpenAI API 키 설정
> ```bash
> export OPENAI_API_KEY=sk-...   # Mac/Linux
> set OPENAI_API_KEY=sk-...      # Windows
> ```
>
> ---
>
> ## Quick Start
>
> ```bash
> # 텍스트 직접 분석
> medguard check --text "마그네슘을 먹으면 불면증이 완치됩니다."
>
> # 파일 분석
> medguard check examples/korean_sleep_caption.txt
>
> # 안전한 표현으로 재작성
> medguard rewrite --text "이 방법만 하면 병원에 가지 않아도 됩니다."
>
> # 연구 논문 초록 → SNS 포스트 변환
> medguard paper-to-post examples/abstract.txt --platform instagram
>
> # JSON 형식으로 출력
> medguard check --text "당뇨가 완치됩니다." --json
> ```
>
> ---
>
> ## Example Output
>
> ```
> medguard check --text "마그네슘을 먹으면 불면증이 대부분 해결됩니다."
>
> ╭─── MedCreatorGuard Report ───╮
> │ Risk Score: 🟡 중간 (Medium) │
> ╰───────────────────────────────╯
>
> Detected Claims
>  Claim                          Type              Evidence  Risk
>  마그네슘 섭취가 불면증을 해결한다  treatment_effect  C         medium
>
> ⚠ Risky Phrases
>   • 대부분 해결됩니다
>     불면증 해결을 과장함
>     → 일부 사람에게 수면 개선에 도움이 될 수 있습니다
>
> ╭─ Suggested Safe Rewrite ─╮
> │ 마그네슘은 일부 사람의 수면 관리에 도움이 될 수 있지만,
> │ 불면증은 다양한 원인이 있습니다. 증상이 지속되면 의료진과
> │ 상담하는 것이 좋습니다.
> ╰───────────────────────────╯
>
> ╭─ Suggested Disclaimer ─╮
> │ 이 콘텐츠는 일반적인 건강 정보 제공 목적이며
> │ 개인의 진단이나 치료를 대체하지 않습니다.
> ╰─────────────────────────╯
> ```
>
> ---
>
> ## Evidence Levels
>
> | Grade | Meaning |
> |-------|---------|
> | **A** | 강한 근거 — 메타분석 / 대규모 RCT |
> | **B** | 중등도 근거 — 소규모 임상 / 관찰연구 |
> | **C** | 제한적 근거 — 전문가 의견 / 기전 추론 |
> | **D** | 근거 부족 또는 과장 가능성 |
>
> ---
>
> ## Development
>
> ```bash
> git clone https://github.com/aimekoreaofficial/MedCreatorGuard.git
> cd MedCreatorGuard
> pip install -e ".[dev]"
> pytest
> ```
>
> ---
>
> ## License
>
> MIT License — 자유롭게 사용, 수정, 배포 가능합니다.
>
> ---
>
> *Built by [@aimekoreaofficial](https://github.com/aimekoreaofficial)*
