Telegram bot for the Digital Freedom Contest
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Peter Lodri 9c5c0924a5 fix: use PyPI ultragraph and defer token check to runtime
- Replace editable path dep with PyPI ultragraph-1bit>=0.17.0

- Move CONTEST_BOT_TOKEN exit from import-time to main()

- Fixes CI build on GitHub Actions
2026-07-13 22:52:37 +02:00
.github/workflows feat: contest-bot — Telegram submission bot for Digital Freedom Contest 2026-07-13 22:50:25 +02:00
src/contest_bot fix: use PyPI ultragraph and defer token check to runtime 2026-07-13 22:52:37 +02:00
.env.example feat: contest-bot — Telegram submission bot for Digital Freedom Contest 2026-07-13 22:50:25 +02:00
.gitignore feat: contest-bot — Telegram submission bot for Digital Freedom Contest 2026-07-13 22:50:25 +02:00
LICENSE feat: contest-bot — Telegram submission bot for Digital Freedom Contest 2026-07-13 22:50:25 +02:00
pyproject.toml fix: use PyPI ultragraph and defer token check to runtime 2026-07-13 22:52:37 +02:00
README.md feat: contest-bot — Telegram submission bot for Digital Freedom Contest 2026-07-13 22:50:25 +02:00
uv.lock fix: use PyPI ultragraph and defer token check to runtime 2026-07-13 22:52:37 +02:00
VIDEO_SCRIPT.md feat: contest-bot — Telegram submission bot for Digital Freedom Contest 2026-07-13 22:50:25 +02:00

contest-bot — Telegram submission bot for the Digital Freedom Contest

build python uv license genesis

A Telegram bot that accepts video submissions for the Digital Freedom Contest. Users pick a contest, answer two short questions, and submit links to videos on TikTok, Instagram, YouTube, Snapchat, or X. Submissions are stored in SQLite; /admin graph renders a knowledge-graph SVG via ultragraph.

Built to demonstrate that digital freedom is not just a topic — it's something you can build, fork, and run yourself.

quick start

git clone https://github.com/peterlodri-sec/telegram-contest.git
cd telegram-contest
cp .env.example .env
# edit .env and set CONTEST_BOT_TOKEN
uv run contest-bot

what it does

  • Multi-step conversation via python-telegram-bot: select contest → answer questions → submit links.
  • Link validation: accepts only TikTok, Instagram, YouTube, Snapchat, X/Twitter URLs.
  • Bulk submissions: multiple links in a single message, separated by newlines.
  • SQLite persistence: users, submissions, and conversation state.
  • Admin commands:
    • /admin — stats dashboard
    • /admin graph — SVG knowledge graph of all submissions
  • Knowledge graph: built with ultragraph, rendered as an SVG grouped by platform with status colors.

environment variables

Variable Required Default
CONTEST_BOT_TOKEN yes —
CONTEST_ADMIN_IDS no (all users allowed)
CONTEST_DB_PATH no ./contest.db
CONTEST_LOG_LEVEL no INFO
CONTEST_DEADLINE no TBD

stack

genesis / provenance

This repository participates in the Vaked provenance chain.

⟳ 7c242080f5f821e5eaf563fe2208d60632c451687baf65f4fe8e4a0d226e3ecf

This is the Vaked genesis seal, notarized in DNS (dig TXT vaked.dev). It anchors the intent of the work: open systems, structural honesty, and the right to inspect, modify, and redistribute the code. The bot is MIT-licensed, but the provenance is immutable.

license

MIT — see LICENSE.