🗒️ TALOS v2: The Amazing List of Stuff

A phone-first personal task list with a calendar beside it.

TALOS v2 is a rethink of TALOS-Manager, which was a team task manager. This version is deliberately personal: one person, one list, zero friction. Tasks carry a title, description, priority tier, category and optional due date. Completing a task doesn't make it jump around: the row fades and keeps its place in the sort, so your list stays a stable map of your day.

Highlights

• Calendar in day / week / month views with deadline hairlines, a now-line and a read-only ICS subscription so it shows up in your other calendars.
• Reminders via APScheduler and web push; installable as a PWA.
• Agent-friendly API: create an API key in Settings and GET /api/v1/agenda returns today's overdue tasks, due tasks and events, offset-aware in your time zone. Built so an AI assistant can read your day.
• Serious auth for a tiny app: 90-day sliding cookie sessions, double-submit CSRF, hashed Bearer API keys, single-use invite links and password resets.
• Ops included: Alembic migrations, a CLI (python -m talos.cli) for users, keys and VAPID setup, backup script and restore notes.

Stack

FastAPI · SQLAlchemy 2.0 · Alembic · SQLite · APScheduler · React 18 + Vite + TypeScript (built into the image and served by the same process) · Docker (one container, one SQLite file).

Layout

backend/    FastAPI app, models, services, routers, Alembic, pytest suite
frontend/   React SPA
ops/        backup.sh, restore.md

Run it

cp .env.example .env
python3 -c "import secrets; print(secrets.token_urlsafe(48))"   # paste into TALOS_SECRET_KEY
docker compose up -d --build
docker exec -it talos python -m talos.cli user add <name> --admin

Tests: cd backend && pytest.