comit new

Dockerfile

@@ -0,0 +1,22 @@
+FROM python:3.11-slim
+
+ENV PYTHONDONTWRITEBYTECODE=1
+ENV PYTHONUNBUFFERED=1
+ENV PIP_NO_CACHE_DIR=1
+
+WORKDIR /code
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    ffmpeg \
+    curl \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY requirements.txt /code/requirements.txt
+RUN pip install --upgrade pip && pip install -r /code/requirements.txt
+
+COPY role_bank.json /code/role_bank.json
+COPY app /code/app
+
+EXPOSE 7860
+
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "7860"]

README.md

@@ -1,11 +1,55 @@
 ---
 title: Japanese AI Interview API
-emoji: 🏢
-colorFrom: indigo
-colorTo: gray
+emoji: 🎤
+colorFrom: blue
+colorTo: indigo
 sdk: docker
-pinned: false
-short_description: Role-based, voice-first Japanese interview practice for work
+app_port: 7860
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Japanese AI Interview API
+
+Role-based, voice-first Japanese interview practice for working visa jobs.
+
+## This build uses
+- Hugging Face Inference ASR for speech-to-text
+- Hugging Face router chat completions for dynamic next-question logic
+- A built-in 654-question bank across 6 job roles
+- N4-level interviewer style
+- Early fail after repeated no-sound or weak answers
+- Up to 20 questions when the interview is going well
+
+## Endpoints
+- `GET /`
+- `GET /health`
+- `GET /roles`
+- `POST /start`
+- `POST /answer`
+
+## Space secrets / variables
+
+### Secret
+- `HF_TOKEN` = Hugging Face token with Inference Providers permission
+
+### Variables
+- `ASR_MODEL` = `openai/whisper-large-v3`
+- `CHAT_MODEL` = `Qwen/Qwen2.5-7B-Instruct-1M`
+- `MAX_QUESTION_LIMIT` = `20`
+
+## Start payload example
+
+```json
+{
+  "session_uuid": "session-123",
+  "job_role": "construction",
+  "question_count": 12
+}
+```
+
+## Available job_role values
+- `construction`
+- `restaurant_konbini`
+- `nursing_care`
+- `hotel_accommodation`
+- `agriculture`
+- `manufacturing`

requirements.txt

@@ -0,0 +1,5 @@
+fastapi==0.115.0
+uvicorn[standard]==0.30.6
+python-multipart==0.0.9
+requests==2.32.3
+pydantic==2.9.2