outing-planner

Outing Planner helps a single user turn raw task notes into a practical weekly plan in Telegram.

Problem

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.

Solution

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.

Prerequisites

• Python 3.11+
• uv
• Telegram bot token
• Ollama running locally

Quick Start

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.main

Optional seed data:

sqlite3 ./data/planner.db < app/seeds/data.sql

Documentation

• 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