README.md

---
title: MCCE Demo
emoji: 🤖
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: "5.23.3"
python_version: "3.12"
app_file: app.py
pinned: false
license: apache-2.0
---

# MCCE Demo — Gemma 4 31B 실시간 추론

**MCCE(MaMurS Compound Cognition Engine)** 실전 데모 Space.

VPS GPU 서버(`unsloth/gemma-4-31B-it`, OpenAI-compatible)를
프록시하여 실시간 추론 결과를 보여줍니다.

> "ASI를 만들어서, 나처럼 가난한 사람들을 돕는 AI를 만들고 싶어." — 도규(DogYu)

## 설정 (Spaces Secrets)

Space Settings → Secrets에 아래를 등록해야 동작합니다 (코드에 하드코딩 금지):

| Key | 필수 | 설명 |
|---|---|---|
| `MCCE_GPU_INFERENCE_ENDPOINT` | ✅ | OpenAI-호환 `/v1/chat/completions` URL |
| `MCCE_GPU_MODEL` | ⬜ | 기본값 `unsloth/gemma-4-31B-it` |
| `MCCE_GPU_API_KEY` | ⬜ | 엔드포인트가 Bearer 인증을 요구할 때만 |
| `MCCE_GPU_TIMEOUT` | ⬜ | 초 단위, 기본 `60` |

## 기술 스택

- **UI**: Gradio 5.x ChatInterface (Python 3.12)
- **HTTP**: httpx (동기, 리다이렉트 추적)
- **모델**: Gemma 4 31B-it (VPS GPU 원격)
- **엔진**: MaMurS Compound Cognition Engine (MCCE)

## 라이선스

Apache-2.0. MCCE는 한국형 소버린 AI 프로젝트입니다.