plannerAgent — Telegram Calendar Bot with NLU
Self-hosted Telegram bot that turns natural-language messages into Google Calendar events and reminders — FastAPI + OpenAI NLU + hardened systemd deployment on a personal Ubuntu VPS.
Project Overview
Personal productivity tool I built and run on my own VPS. Drop a free-text message on Telegram ("remind me about the dentist at 4 tomorrow") and it becomes a real Google Calendar event with a reminder pushed back through the bot. FastAPI orchestrates an asyncio long-poll loop, a shared HTTP/2 httpx client to Telegram, OpenAI for natural-language parsing, the Google Calendar API for event upserts, and a SQLite-backed reminders engine with a windowed scan and dedup cache. Deployed as a hardened systemd unit (non-login user, ProtectSystem=strict, scoped ReadWritePaths) via an idempotent install script. Secrets are environment variables — nothing sensitive is committed.