From a4ccd9a107bd7e968df4c7e53cffed73f46054fb Mon Sep 17 00:00:00 2001
From: Danny <dth@taiga.ai>
Date: Fri, 17 Apr 2026 14:21:12 +0200
Subject: [PATCH] docs: add LICENSE (MIT) and README

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 LICENSE   | 21 +++++++++++++++
 README.md | 81 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 102 insertions(+)
 create mode 100644 LICENSE
 create mode 100644 README.md

diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..09bb404
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DannyDannyDanny
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5880561
--- /dev/null
+++ b/README.md
@@ -0,0 +1,81 @@
+# 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
+
+```bash
+nix run
+```
+
+This launches:
+- API server (port 8080)
+- cloudflared tunnel for the Mini App
+- Telegram bot (polling)
+
+Put your bot token (from [@BotFather](https://t.me/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
+
+```bash
+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](LICENSE).