Outing Planner helps a single user turn raw task notes into a practical weekly plan in Telegram.
Weekly errands and obligations are easy to miss or schedule poorly when entered as free text. The result is fragmented days, conflicts, and unclear priorities.
A Telegram bot collects tasks and unavailable time, stores them in SQLite, and generates a deterministic weekly plan. AI assists with text interpretation and explanation, while deterministic logic remains the final planner authority.
- Python 3.11+
uv- Telegram bot token
- Ollama running locally
uv venv .venv
source .venv/bin/activate
uv sync --extra dev
cp .env.example .env
ollama serve
ollama pull llama3.1:8b
uv run python -m app.mainOptional seed data:
sqlite3 ./data/planner.db < app/seeds/data.sql- Product scope, user workflow, and feature set:
docs/product.md - Technical architecture and boundaries:
docs/architecture.md - AI responsibility boundaries and contracts:
docs/ai-approach.md - Database schema and invariants:
docs/db.md - Repository layout:
docs/folder-structure.md