A gamified, AI-powered vision board that turns life goals into an RPG adventure
Break ambitious goals into actionable "quests", earn XP for finishing tasks, and level up your life — with an AI architect that decomposes big goals for you.
📸 Add a screenshot here — a real screenshot of your dashboard sells this project far better than any description. Drop it in
docs/and reference it:
QuestLog treats goal-setting as an engineering problem: goals are decomposed by AI into concrete, trackable steps, wrapped in game mechanics that keep execution measurable and motivating.
- 🤖 AI Architect — let the AI break a Main Quest (e.g. "Run a marathon") into actionable, scheduled sub-quests automatically.
- 🎮 Gamified progression — earn XP for every completed task and level your hero profile from Novice to Visionary.
- 🔮 Visual vision board — the dashboard dynamically reflects your goal with AI-generated art.
- 🗣️ Motivation engine — a fresh, goal-tailored motivational quote generated daily.
- 🔓 Unlockable themes — start on Cyberpunk; unlock Zen Garden (Lvl 3) and Minimalist (Lvl 5).
- 🔥 Overdue logic — missed deadlines light up with visual warnings to keep you accountable.
- 🔄 Drag & drop — reorganize your day by dragging tasks.
- 💾 Data safety — export your entire progress to JSON at any time.
| Layer | Technology |
|---|---|
| Backend | Python · FastAPI · Uvicorn |
| Database | SQLAlchemy · SQLite |
| Frontend | Jinja2 server-rendered templates · CSS |
| AI | Google Gemini (google-genai) |
Requirements: Python 3.11+ and a Google Gemini API key.
# 1. Clone
git clone https://github.com/Thijsn04/QuestLog.git
cd QuestLog
# 2. Virtual environment
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
# 3. Install dependencies
pip install -r requirements.txt
# 4. Configure your API key
cp .env.example .env # then add your GEMINI_API_KEY
# 5. Run
python main.py # http://localhost:8000See LICENSE.
Built by Thijs Nannings · Medical Informatics @ UvA · Lythos