Your personal AI assistant in Telegram. Nothing else. 🪓

---

No WhatsApp. No Discord. No Slack. No 47 integrations you'll never use.

Just Telegram. Three LLM providers — Anthropic, OpenAI, Gemini. One config. You're done. ⚔️

Install

Grab uv if you don't have it:

curl -LsSf https://astral.sh/uv/install.sh | sh

Then:

uv tool install ragnarbot-ai

Setup

🪓 Step 1: Create a Telegram bot

1. Open Telegram, find @BotFather
2. Send /newbot, follow the prompts, pick a name
3. Copy the token it gives you — you'll need it in a sec

🪓 Step 2: Onboard

ragnarbot onboard

Answer a few questions (provider, API key, paste that bot token) and you're live. No config files to edit by hand, no YAML to debug at 2am.

Access

Once the bot is running, just message it. If someone unauthorized tries to talk to it, the bot will send them an access code. You run one command in your terminal to approve them. That's it — no manual config editing, no user ID lookups.

🏃 Run

ragnarbot gateway

Your bot is alive. Go text it.

To manage the gateway:

ragnarbot gateway start    # start as a background daemon
ragnarbot gateway stop     # stop the daemon
ragnarbot gateway restart  # restart the daemon
ragnarbot gateway delete   # remove the daemon completely

---

MIT · Based on nanobot