A modern text-based adventure game inspired by Zork, powered by Large Language Models.

Zaik combines classic text adventure gameplay with AI-powered natural language understanding to create dynamic, immersive interactive fiction experiences.

• Frontend: React-based terminal interface
• Backend: Python with FastAPI
• Database: Document database (MongoDB/CouchDB)
• LLM Integration: Custom server for AI-powered interactions

zaik/
├── backend/          # Python FastAPI server
├── frontend/         # React application
├── docs/            # Project documentation
└── CLAUDE.md        # Development instructions

• Docker - For running services and building deployments
• mise - For local development (optional)
• uv - Fast Python package management (optional, for local development)

Start the entire game stack (frontend + backend) with one command:

# Start all services in development mode
docker compose up

# Or run in detached mode
docker compose up -d

Access the services:

• Frontend: http://localhost:5173
• Backend API: http://localhost:8000
• API Docs: http://localhost:8000/docs

Stop services:

docker compose down

For production deployment:

# Build and run production containers
docker compose -f docker-compose.prod.yml up -d

Production URLs:

• Frontend: http://localhost:80
• Backend API: http://localhost:8000

For local development without Docker:

Backend:

cd backend
mise install
source venv/bin/activate
python -m uvicorn app.main:app --reload

Frontend:

cd frontend
npm install
npm run dev

See backend/README.md and frontend/README.md for detailed setup instructions.

See CLAUDE.md for detailed development instructions and workflow.

This project is in early development. Check the Notion board for current progress and roadmap.