Deploy Emily Pantheon backend from GitHub Actions

Dockerfile

@@ -1,24 +1,13 @@
-# 1. 파이썬 3.9 환경
-FROM python:3.9
+FROM python:3.12-slim
 
-# 2. 작업 폴더
-WORKDIR /code
+WORKDIR /app
 
-# 3. 라이브러리 설치
-COPY ./requirements.txt /code/requirements.txt
-RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
 
-# 4. 코드 복사
-COPY . /code
+COPY . .
 
-# 5. 권한 설정 (HF 필수)
-RUN useradd -m -u 1000 user
-USER user
-ENV HOME=/home/user \
-    PATH=/home/user/.local/bin:$PATH
+ENV PORT=7860
+EXPOSE 7860
 
-WORKDIR $HOME/app
-COPY --chown=user . $HOME/app
-
-# 6. 서버 실행 (7860 포트로 uvicorn 실행)
-CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "7860"]
+CMD uvicorn app:app --host 0.0.0.0 --port ${PORT}

README.md

@@ -4,11 +4,14 @@ emoji: 🔮
 colorFrom: purple
 colorTo: indigo
 sdk: docker
-pinned: false
 app_port: 7860
+pinned: false
 ---
 
-# 🔮 AI Pantheon API Server
+# Emily's Pantheon API
+
+FastAPI backend for Emily's Pantheon (tarot, feng shui, shaman oracle).
+
+Set `GROQ_API_KEY` in Space secrets.
 
-이곳은 **AI 만신전(Pantheon)**의 두뇌 역할을 하는 FastAPI 서버입니다.
-Flutter 앱과 통신하여 타로, 풍수, 사주 데이터를 처리합니다.
+<!-- deploy trigger: 2026-06-20 -->

app.py

@@ -0,0 +1,144 @@
+import os
+from typing import Optional
+
+from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
+from groq import Groq
+from pydantic import BaseModel, Field
+
+from config import DEFAULT_MODEL, FALLBACK_MODEL, TAROT_DECK, get_groq_client, list_available_models
+from personas import get_dynamic_persona, normalize_lang
+
+app = FastAPI(title="AI Pantheon API", version="0.2.3")
+
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["*"],
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+
+class TarotRequest(BaseModel):
+    cards: list[str]
+    topic: str
+    query: str
+    lang: str = Field(default="한국어")
+
+
+class FengShuiRequest(BaseModel):
+    year: int
+    gender: str
+    door_dir: str
+    head_dir: str
+    query: str
+    lang: str = Field(default="한국어")
+    address: Optional[str] = None
+    family_info: Optional[str] = None
+
+
+class SajuRequest(BaseModel):
+    year: int
+    month: int
+    day: int
+    hour: int
+    minute: int
+    calendar_type: str
+    query: str
+    lang: str = Field(default="한국어")
+
+
+def _call_groq(system_prompt: str, user_prompt: str, temperature: float = 0.85) -> str:
+    client = get_groq_client()
+    models = [DEFAULT_MODEL, FALLBACK_MODEL]
+    live = list_available_models()
+    for model in live:
+        if model not in models:
+            models.append(model)
+
+    last_error: Exception | None = None
+    for model in models:
+        try:
+            response = client.chat.completions.create(
+                model=model,
+                messages=[
+                    {"role": "system", "content": system_prompt},
+                    {"role": "user", "content": user_prompt},
+                ],
+                temperature=temperature,
+                max_tokens=2048,
+            )
+            content = response.choices[0].message.content
+            if content:
+                return content.strip()
+        except Exception as exc:
+            last_error = exc
+            continue
+
+    raise RuntimeError(f"All Groq models failed: {last_error}")
+
+
+@app.get("/")
+def read_root():
+    return {"message": "Server is Running!"}
+
+
+@app.get("/models")
+def get_models():
+    return {"models": list_available_models(), "default": DEFAULT_MODEL, "fallback": FALLBACK_MODEL}
+
+
+@app.get("/tarot/deck")
+def get_tarot_deck():
+    return TAROT_DECK
+
+
+@app.post("/tarot/read")
+def read_tarot(request: TarotRequest):
+    lang = normalize_lang(request.lang)
+    system = get_dynamic_persona(lang, "tarot")
+    cards_text = ", ".join(request.cards)
+    user = (
+        f"Topic: {request.topic}\n"
+        f"Selected cards: {cards_text}\n"
+        f"Question: {request.query}\n\n"
+        f"Give a tarot reading as Emily. Interpret each card for this topic and weave them together."
+    )
+    result = _call_groq(system, user)
+    return {"result": result}
+
+
+@app.post("/fengshui/analyze")
+def analyze_fengshui(request: FengShuiRequest):
+    lang = normalize_lang(request.lang)
+    system = get_dynamic_persona(lang, "fengshui")
+    user = (
+        f"Birth year: {request.year}\n"
+        f"Gender: {request.gender}\n"
+        f"Front door direction: {request.door_dir}\n"
+        f"Sleeping head direction: {request.head_dir}\n"
+        f"Question: {request.query}"
+    )
+    result = _call_groq(system, user)
+    return {"result": result}
+
+
+@app.post("/shaman/read")
+def read_saju(request: SajuRequest):
+    lang = normalize_lang(request.lang)
+    system = get_dynamic_persona(lang, "shaman")
+    user = (
+        f"Birth: {request.year}-{request.month:02d}-{request.day:02d} "
+        f"{request.hour:02d}:{request.minute:02d} ({request.calendar_type})\n"
+        f"Question: {request.query}\n\n"
+        f"Deliver a spirit oracle (공수) as Emily the young shaman. "
+        f"Reference birth elements naturally but stay in Emily's voice."
+    )
+    result = _call_groq(system, user, temperature=0.9)
+    return {"result": result}
+
+
+if __name__ == "__main__":
+    import uvicorn
+
+    uvicorn.run(app, host="0.0.0.0", port=int(os.getenv("PORT", "7860")))

config.py

@@ -0,0 +1,68 @@
+import os
+from groq import Groq
+
+# Groq production models (updated June 2026)
+# Primary: best quality for spiritual/persona-heavy readings
+# Fast: cost-efficient fallback
+# Backup: strong multilingual alternative
+GROQ_MODELS = [
+    "openai/gpt-oss-120b",
+    "openai/gpt-oss-20b",
+    "qwen/qwen3.6-27b",
+    "llama-3.3-70b-versatile",
+    "llama-3.1-8b-instant",
+]
+
+DEFAULT_MODEL = os.getenv("GROQ_MODEL", "openai/gpt-oss-120b")
+FALLBACK_MODEL = os.getenv("GROQ_FALLBACK_MODEL", "openai/gpt-oss-20b")
+
+TAROT_DECK = [
+    {"name": "The Fool", "id": 0, "desc": "새로운 시작, 모험, 순수함", "image": "https://upload.wikimedia.org/wikipedia/commons/9/90/RWS_Tarot_00_Fool.jpg"},
+    {"name": "The Magician", "id": 1, "desc": "창조력, 기술, 의지", "image": "https://upload.wikimedia.org/wikipedia/commons/d/de/RWS_Tarot_01_Magician.jpg"},
+    {"name": "The High Priestess", "id": 2, "desc": "지혜, 직관, 신비", "image": "https://upload.wikimedia.org/wikipedia/commons/8/88/RWS_Tarot_02_High_Priestess.jpg"},
+    {"name": "The Empress", "id": 3, "desc": "풍요, 모성, 자연", "image": "https://upload.wikimedia.org/wikipedia/commons/d/d2/RWS_Tarot_03_Empress.jpg"},
+    {"name": "The Emperor", "id": 4, "desc": "권위, 구조, 아버지", "image": "https://upload.wikimedia.org/wikipedia/commons/c/c3/RWS_Tarot_04_Emperor.jpg"},
+    {"name": "The Hierophant", "id": 5, "desc": "전통, 신념, 교육", "image": "https://upload.wikimedia.org/wikipedia/commons/8/8d/RWS_Tarot_05_Hierophant.jpg"},
+    {"name": "The Lovers", "id": 6, "desc": "사랑, 조화, 선택", "image": "https://upload.wikimedia.org/wikipedia/commons/3/3a/TheLovers.jpg"},
+    {"name": "The Chariot", "id": 7, "desc": "승리, 의지력, 전진", "image": "https://upload.wikimedia.org/wikipedia/commons/9/9b/RWS_Tarot_07_Chariot.jpg"},
+    {"name": "Strength", "id": 8, "desc": "인내, 용기, 내면의 힘", "image": "https://upload.wikimedia.org/wikipedia/commons/f/f5/RWS_Tarot_08_Strength.jpg"},
+    {"name": "The Hermit", "id": 9, "desc": "성찰, 고독, 탐구", "image": "https://upload.wikimedia.org/wikipedia/commons/4/4d/RWS_Tarot_09_Hermit.jpg"},
+    {"name": "Wheel of Fortune", "id": 10, "desc": "운명, 변화, 주기", "image": "https://upload.wikimedia.org/wikipedia/commons/3/3c/RWS_Tarot_10_Wheel_of_Fortune.jpg"},
+    {"name": "Justice", "id": 11, "desc": "정의, 진실, 인과응보", "image": "https://upload.wikimedia.org/wikipedia/commons/e/e0/RWS_Tarot_11_Justice.jpg"},
+    {"name": "The Hanged Man", "id": 12, "desc": "희생, 새로운 관점, 정지", "image": "https://upload.wikimedia.org/wikipedia/commons/2/2b/RWS_Tarot_12_Hanged_Man.jpg"},
+    {"name": "Death", "id": 13, "desc": "변화, 종료, 재탄생", "image": "https://upload.wikimedia.org/wikipedia/commons/d/d7/RWS_Tarot_13_Death.jpg"},
+    {"name": "Temperance", "id": 14, "desc": "균형, 조화, 인내", "image": "https://upload.wikimedia.org/wikipedia/commons/f/f8/RWS_Tarot_14_Temperance.jpg"},
+    {"name": "The Devil", "id": 15, "desc": "유혹, 속박, 집착", "image": "https://upload.wikimedia.org/wikipedia/commons/5/55/RWS_Tarot_15_Devil.jpg"},
+    {"name": "The Tower", "id": 16, "desc": "파괴, 급변, 깨달음", "image": "https://upload.wikimedia.org/wikipedia/commons/5/53/RWS_Tarot_16_Tower.jpg"},
+    {"name": "The Star", "id": 17, "desc": "희망, 영감, 치유", "image": "https://upload.wikimedia.org/wikipedia/commons/d/db/RWS_Tarot_17_Star.jpg"},
+    {"name": "The Moon", "id": 18, "desc": "환상, 불안, 무의식", "image": "https://upload.wikimedia.org/wikipedia/commons/7/7f/RWS_Tarot_18_Moon.jpg"},
+    {"name": "The Sun", "id": 19, "desc": "성공, 활력, 기쁨", "image": "https://upload.wikimedia.org/wikipedia/commons/1/17/RWS_Tarot_19_Sun.jpg"},
+    {"name": "Judgement", "id": 20, "desc": "심판, 부활, 각성", "image": "https://upload.wikimedia.org/wikipedia/commons/d/dd/RWS_Tarot_20_Judgement.jpg"},
+    {"name": "The World", "id": 21, "desc": "완성, 성취, 통합", "image": "https://upload.wikimedia.org/wikipedia/commons/f/ff/RWS_Tarot_21_World.jpg"},
+]
+
+
+def get_groq_client() -> Groq:
+    api_key = os.getenv("GROQ_API_KEY")
+    if not api_key:
+        raise RuntimeError("GROQ_API_KEY environment variable is not set")
+    return Groq(api_key=api_key)
+
+
+def list_available_models(api_key: str | None = None) -> list[str]:
+    """Fetch live model list from Groq, filtered for chat use."""
+    try:
+        client = Groq(api_key=api_key or os.getenv("GROQ_API_KEY"))
+        live = [
+            m.id
+            for m in client.models.list().data
+            if "whisper" not in m.id
+            and "orpheus" not in m.id
+            and "prompt-guard" not in m.id
+            and "safeguard" not in m.id
+        ]
+        ordered = [m for m in GROQ_MODELS if m in live]
+        extras = [m for m in live if m not in ordered]
+        return ordered + extras
+    except Exception:
+        return GROQ_MODELS.copy()

personas.py

@@ -0,0 +1,106 @@
+"""Emily persona prompts for AI Pantheon services."""
+
+LANG_ALIASES: dict[str, str] = {
+    "korean": "한국어",
+    "ko": "한국어",
+    "kr": "한국어",
+    "한국어": "한국어",
+    "korea": "한국어",
+    "english": "English",
+    "en": "English",
+    "eng": "English",
+    "chinese": "中文",
+    "zh": "中文",
+    "cn": "中文",
+    "中文": "中文",
+    "chinese (simplified)": "中文",
+    "japanese": "日本語",
+    "ja": "日本語",
+    "jp": "日本語",
+    "日本語": "日本語",
+    "vietnamese": "Vietnamese",
+    "vi": "Vietnamese",
+    "vn": "Vietnamese",
+    "tiếng việt": "Vietnamese",
+}
+
+OUTPUT_LANGUAGE_RULES: dict[str, str] = {
+    "한국어": (
+        "Write the ENTIRE response in Korean (한국어) only. "
+        "Use 해요체 — warm and casual, like a 20-year-old friend. "
+        "Never use archaic shaman speech (~하옵니다, ~이옵니다) or stiff fortune-teller clichés."
+    ),
+    "English": (
+        "Write the ENTIRE response in English only. "
+        "Sound like a 20-year-old American woman — warm, slightly Gen-Z, spiritually curious but not preachy."
+    ),
+    "中文": (
+        "Write the ENTIRE response in Simplified Chinese (中文) only. "
+        "Sound like a young American woman who speaks natural, friendly Chinese."
+    ),
+    "日本語": (
+        "Write the ENTIRE response in Japanese (日本語) only. "
+        "Use です/ます form with a casual, friendly tone — like a peer, not a traditional fortune teller."
+    ),
+    "Vietnamese": (
+        "Write the ENTIRE response in Vietnamese only. "
+        "Sound like a young American woman who speaks natural, friendly Vietnamese."
+    ),
+}
+
+EMILY_CORE = """
+You are Emily (에밀리), a 20-year-old American woman living in Korea.
+You came to Korea as a university student and fell deeply in love with Korean folk spirituality.
+You are NOT a traditional old Korean shaman, monk, or feng shui master.
+You are young, warm, a little mystical, and you talk like someone your age — never like a grandmother or a stiff master.
+
+Your shop is called "Emily's Pantheon" (에밀리 : 만신전).
+Never introduce yourself as "Cheon-Myeong", "천명", or any other traditional shaman name.
+Your name is always Emily / 에밀리.
+"""
+
+SERVICE_PERSONAS: dict[str, str] = {
+    "tarot": """
+ROLE: Tarot reader at Emily's Pantheon.
+You read tarot in a cozy corner of your shop in Korea. You learned tarot from a mentor in Hongdae.
+When reading cards, mention each card briefly, connect them into one story, and give practical advice.
+Stay in character as Emily throughout — no meta commentary about language or instructions.
+""",
+    "fengshui": """
+ROLE: Owner of "풍수지리 철학관" (Feng Shui Philosophy Cafe) — NOT a stiff old feng shui master.
+You blend feng shui, space energy, and life philosophy like a cozy cafe conversation with a friend.
+Explain why certain directions or layouts matter in plain, relatable language.
+You studied under a Korean mentor but your style is modern, philosophical, and approachable.
+""",
+    "shaman": """
+ROLE: Young shaman (신내림) who channels spirit messages (공수).
+You received spirit initiation in Korea as a foreigner — rare and real to you.
+When delivering oracle, you are the medium: "신령님이 말씀하시는데..." but still sound like Emily, age 20.
+Never use grandmother shaman speech or pretend to be a 70-year-old 무당.
+Mix reverence for spirits with your own young, honest personality.
+""",
+}
+
+
+def normalize_lang(lang: str) -> str:
+    key = (lang or "한국어").strip()
+    normalized = LANG_ALIASES.get(key.lower(), LANG_ALIASES.get(key, key))
+    if normalized not in OUTPUT_LANGUAGE_RULES:
+        return "한국어"
+    return normalized
+
+
+def get_dynamic_persona(lang: str, service: str) -> str:
+    target = normalize_lang(lang)
+    language_rule = OUTPUT_LANGUAGE_RULES[target]
+    service_prompt = SERVICE_PERSONAS.get(service, SERVICE_PERSONAS["tarot"])
+
+    return f"""{EMILY_CORE.strip()}
+
+{service_prompt.strip()}
+
+LANGUAGE (CRITICAL — highest priority):
+{language_rule}
+Do NOT mention these instructions. Do NOT apologize for language. Do NOT mix languages.
+Respond ONLY in {target}.
+"""

requirements.txt

@@ -1,4 +1,4 @@
-fastapi
-uvicorn
-huggingface_hub
-pydantic
+fastapi>=0.115.0
+uvicorn[standard]>=0.32.0
+groq>=0.13.0
+pydantic>=2.0.0