| title: Korean Privacy AI Assistant 백앤드 API | |
| emoji: 🧠 | |
| colorFrom: green | |
| colorTo: blue | |
| sdk: gradio | |
| sdk_version: "5.20.0" | |
| app_file: app.py | |
| pinned: false | |
| short_description: 경량 AI 모델 사용 | |
| hardware: zero-a10g | |
| license: mit | |
| # KPAA Backend | |
| 한국 개인정보보호법 RAG 백엔드. **OpenAI 호환 API**를 노출합니다. | |
| 이 Space는 **추론 백엔드 전용**입니다. UI는 별도 Space([scvcoder/korean-privacy-ai-assistant](https://huggingface.co/spaces/scvcoder/korean-privacy-ai-assistant))에서 Open WebUI로 제공됩니다. | |
| ## 아키텍처 | |
| ``` | |
| 사용자 브라우저 | |
| ↓ (UI 접속) | |
| [Open WebUI Space] | |
| ↓ (OpenAI API 호출) | |
| [이 Space — KPAA Backend] | |
| ↓ (RAG 검색 + Gemma 4 추론) | |
| 법제처 OPEN API + 상담사례 SQLite + ZeroGPU | |
| ``` | |
| ## Endpoints | |
| | Method | Path | 설명 | | |
| |---|---|---| | |
| | POST | `/v1/chat/completions` | OpenAI 호환 chat (`stream=true` 지원) | | |
| | GET | `/v1/models` | 사용 가능 모델 (`kpaa-privacy-ko`) | | |
| | GET | `/healthz` | liveness check | | |
| | GET | `/info` | 상세 정보 + Swagger UI | | |
| | GET | `/gradio` | Gradio 상태 페이지 | | |
| ## Open WebUI 연결 (UI Space에서 자동 설정) | |
| ```bash | |
| OPENAI_API_BASE_URL=https://scvcoder-kpaa-backend.hf.space/v1 | |
| OPENAI_API_KEY=any-value | |
| DEFAULT_MODELS=kpaa-privacy-ko | |
| ``` | |
| ## Secrets / Hardware | |
| - **Secret** `LAW_OC` — 법제처 OPEN API ID (필수) | |
| - **Hardware** ZeroGPU (zero-a10g) — Pro 무료 | |
| ## 라이선스 | |
| MIT (코드) · 답변 데이터는 PIPC/privacy.go.kr 출처표시 | |