Buzz-Bot

Podcast player for the AI epoch.

Listen to any podcast, then tap one button and hear it in your language — same voices, different words.

Buzz-Bot runs inside Telegram as a Mini App and uses a cloud GPU pipeline (RunPod Serverless) to transcribe, translate, and re-synthesize every speaker's voice.

To view AI pipeline for podcast dubbing workflow check this repository

---

Features

---

Tech Stack

---

Quick Start

Prerequisites

• Crystal >= 1.9 + shards
• Node.js >= 18 + npm
• Docker
• PostgreSQL (Neon free tier works)
• Telegram bot token from @BotFather
• Public HTTPS URL for webhooks

1. Clone and install dependencies

git clone https://github.com/yourname/buzz-bot.git
cd buzz-bot
shards install
npm install

2. Configure environment

cp k8s/secret.example.yaml k8s/secret.yaml
# Fill in all values — see docs/DEPLOYMENT.md for variable reference

3. Run migrations

for f in migrations/*.sql; do psql "$DATABASE_URL" -f "$f"; done

4. Build frontend

# Development (live reload)
npx shadow-cljs watch app

# Production
npx shadow-cljs release app

5. Run locally

crystal run src/buzz_bot.cr

Use Cloudflare Tunnel to expose localhost over HTTPS for Telegram webhooks:

# Terminal 1 — ClojureScript watch build
npx shadow-cljs watch app

# Terminal 2 — tunnel + Crystal server
./devrun.sh           # auto-detects named tunnel or quick tunnel
./devrun.sh --quick   # temporary URL, no account needed

---

Documentation

• AI Dubbing Pipeline — how dubbing works, supported languages, progress tracking
• Recommendations — hybrid vector + collaborative filtering, topic extraction & clustering, explainability
• Deployment Guide — k3s setup, environment variables, monitoring
• API Reference — routes, database schema, feature flags

---

License

MIT