⚔️ MYTHOS - Gamified Life Management

A fantasy-themed productivity app that turns your daily tasks into an RPG adventure.

🚀 Quick Start

Prerequisites

• Python 3.9+
• Node.js 18+ (for frontend)

1. Configure Environment

Create a .env file in the project root:

ANTHROPIC_API_KEY=your-key-here
SUPABASE_HOST=your-host.supabase.co
SUPABASE_PORT=5432
SUPABASE_DB=postgres
SUPABASE_USER=postgres
SUPABASE_PASSWORD=your-password

2. Start Everything

.\start_servers.ps1

This starts:

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

3. Backend Only (No Node.js needed)

cd backend
pip install -r requirements.txt
python main.py

🎯 Features

• Character Creation: AI-generated fantasy world introductions
• Daily Tasks: Personalized tasks based on your goals
• Quest System: Special narrative quests with rewards
• XP & Leveling: Track progress and level up
• Knowledge Graph: AI tracks your story and world state

📁 Project Structure

├── backend/           # FastAPI Python backend
│   ├── main.py        # API endpoints
│   ├── ai_service.py  # Anthropic AI integration
│   ├── database.py    # Supabase operations
│   └── models.py      # Pydantic models
├── frontend/          # React TypeScript frontend
│   └── src/app/       # React components & pages
├── ai_part/           # AI service reference implementation
└── start_servers.ps1  # One-click launcher

🧪 Testing

cd backend
python test_api.py

🛠️ Tech Stack

• Backend: FastAPI, Python, asyncpg
• Frontend: React, TypeScript, Vite, Tailwind CSS
• Database: PostgreSQL (Supabase)
• AI: Anthropic Claude

📚 API Endpoints

Method	Endpoint	Description
POST	/api/create_character	Create character with world intro
GET	/api/character	Get character info
POST	/api/generate_tasks	Generate daily tasks
GET	/api/tasks/today	Get today's tasks
POST	/api/complete_task/{id}	Complete a task
POST	/api/end_day	End day, get narrative
GET	/api/knowledge_graph	View knowledge graph