Build production-ready Telegram bots with middleware, webhooks, conversations, sessions, framework adapters, and broad Bot API v9.6 coverage.
npm install vibegramThe homepage now points developers to the practical path: understand the pipeline, choose an adapter, then reach for the API surfaces they need.
Async onion-model pipeline for commands, filters, plugins, and multi-step flows.
Express, Fastify, Hono, Koa, and native HTTP with secret token validation.
Async wait-state conversations for natural bot dialogs that stay testable.
Per-user and per-chat state with storage adapters and approachable typing.
Modern context methods and types for messages, media, admin, business, and new flows.
VibeGram keeps the important pieces explicit: typed APIs, predictable launch modes, adapter boundaries, and errors you can reason about.
Clearer API contracts.
Safe for modern Node setups.
Secret token validation.
Built-in throttle middleware.
Lifecycle hooks and logger.
A short path that mirrors the docs structure: install, create a bot, add handlers, then choose polling or webhook mode.
Add the package to a Node.js project.
npm install vibegramCreate a Bot instance with a token from env.
const bot = new Bot(process.env.BOT_TOKEN!)Compose commands, filters, middleware, and scenes.
bot.command('start', ctx => ctx.reply('Ready'))Choose local polling or production webhooks.
await bot.launch()Start with the quickstart when you are exploring, or jump into API reference when you are integrating an existing bot.