Danny a4ccd9a107 docs: add LICENSE (MIT) and README

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-04-17 14:21:12 +02:00

2.2 KiB

Raw Blame History

BigBiggerBiggestBot

A Telegram bot for logging gym workouts, with an embedded Mini App.

Send workouts as plain text, forward them from Saved Messages, or tap through a structured log form inside Telegram. History, stats, notes, edit & delete, JSON/CSV export — all per-user, all in SQLite.

Format

Send messages like:

Bench press: 4x8x35
Shoulder press (3032): 8x25, 5x35, 6x40
Pull-ups: 3x10

SETSxREPSxWEIGHT — uniform sets
REPSxWEIGHT, REPSxWEIGHT, ... — per-set (weight/reps vary)
Omit weight for bodyweight exercises
(machine_id) is optional (gym equipment ID)
Blank line separates superset groups; consecutive lines form a superset
Both , and . work as decimal separators

Commands

/start — help & open Mini App
/history — recent workouts
/stats — summary (total workouts, sets, volume)
/delete <id> — soft-delete a workout
/export — download all data as JSON
/feedback <text> — send feedback to the bot author

Run locally

nix run

This launches:

API server (port 8080)
cloudflared tunnel for the Mini App
Telegram bot (polling)

Put your bot token (from @BotFather) in ~/.secrets/bigbiggerbiggestbot or a .env file:

BOT_TOKEN=123456:your-bot-token-here

nix develop drops you into a dev shell with Python + deps.

Tests

nix develop --command pytest tests/ -v

Deployment

Runs as a systemd service. A timer pulls this repo periodically and restarts the service when the remote has new commits — push to main and the bot redeploys itself within ~15 minutes.

The SQLite database lives next to the code at workouts.db (gitignored).

Architecture

bot.py — Telegram command handlers, polling, message parsing
server.py — aiohttp REST API + static file server for the Mini App
db.py — SQLite data layer (workouts, supersets, exercises, feedback; soft delete)
parser.py — workout text → structured data
webapp/ — Mini App (HTML/CSS/vanilla JS, Telegram WebApp SDK)
start.py — orchestrator: starts server + tunnel + bot, wires up the Mini App URL
tests/ — pytest suite for parser + db

License

MIT — see LICENSE.

2.2 KiB Raw Blame History