parththakkar106andClaude Fable 5
466d7bc0e4
Phases: public repo & Docker (7), guest-first optional accounts (8), production hardening (9), Render deploy (10). Confirmed decisions and per-phase open questions recorded in each file. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KFsGHju9szibJJa2YJcdbg
AI D&D — local AI Dungeon-style storytelling app
Python (FastAPI + SQLite) backend, React (Vite) frontend, connectable to any OpenAI-compatible AI endpoint (Ollama, LM Studio, OpenAI, OpenRouter, …).
Plan: see plan/00-OVERVIEW.md. Currently completed: Phase 4 (AI Dungeon-compatible scripting).
Run
.\start.ps1
Then open http://localhost:5173. Backend API docs at http://localhost:8000/docs.
Or manually, in two terminals:
# Terminal 1 — backend
cd backend
.\.venv\Scripts\uvicorn.exe app.main:app --port 8000 --reload
# Terminal 2 — frontend
cd frontend
npm run dev
First-time setup
cd backend
python -m venv .venv
.\.venv\Scripts\pip.exe install -r requirements.txt
cd ..\frontend
npm install
Production-ish serving (single port)
Build the frontend, then the backend serves it statically:
cd frontend
npm run build
# then run the backend and open http://localhost:8000
Layout
backend/app/— FastAPI app:models.py(SQLAlchemy),schemas.py(Pydantic),routers/backend/data.db— SQLite database (created on first run)frontend/src/— React SPA:pages/,api.jsplan/— phased implementation plan