From console to conversation

Connect MUSE AI to Telegram.

Deploy the included webhook worker and configure your existing bot securely. Never enter API keys in this browser.

This preview is not a running Telegram bot. The Free console has real AI but no live search. A separate Cloudflare deployment supplies the webhook, private storage, and Tavily integration.

1. Prepare your deployment

Export the complete project, or download the worker files below into a worker/ directory. Use Node.js 20 or later and a Cloudflare account. This app’s package.json includes the deployment commands.

2. Set secrets & deploy

npm install
npx wrangler login
npx wrangler secret put TELEGRAM_BOT_TOKEN --config worker/wrangler.toml
npx wrangler secret put TELEGRAM_WEBHOOK_SECRET --config worker/wrangler.toml
npx wrangler secret put AI_API_KEY --config worker/wrangler.toml
npx wrangler secret put TAVILY_API_KEY --config worker/wrangler.toml
npm run test:bot
npm run deploy:bot
node worker/register.mjs

Wrangler prompts for each secret locally. Generate a webhook secret with openssl rand -hex 32. Registration uses your deployed HTTPS worker URL and the same secret.

3. Verify in Telegram

Send /start, ask a real question, then a follow-up. Ask a current-facts question and inspect the source links. Test a second user and /clear before public launch.

Open verification checklist

Server-side secrets

TELEGRAM_BOT_TOKEN

Your existing Telegram bot token.

TELEGRAM_WEBHOOK_SECRET

A random secret that authenticates updates.

AI_API_KEY

Your configured LLM provider key.

TAVILY_API_KEY

Your Tavily search key.

Configurable, not hardcoded

Set AI_PROVIDER, AI_MODEL, SEARCH_PROVIDER, and HISTORY_LIMIT in wrangler.toml. OpenAI is the default; compatible providers use an HTTPS AI_BASE_URL secret and Chat Completions format.

Costs & honest limits

Included console AI: 100 requests/hour per app on Free.
Built-in console live search needs Pro in Add-ons. It is not enabled here.
The worker uses your separately billed AI provider and Tavily account.
Cloudflare hosting has quotas and potential costs. No 24/7 operation has been verified.

Full limits, pricing references, and reliability caveats are in DEPLOYMENT.md.