telegram-bot

Creates and runs a polling Telegram bot with pyTelegramBotAPI, uv environment, and optional SSH deployment.

2|Updated Aug 3, 2026
One-click install
npx skills add https://github.com/yandex-ai-studio/teen-museum-residence-2026 --skill telegram-bot-yandex-ai-studio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: telegram-bot
Source: https://github.com/yandex-ai-studio/teen-museum-residence-2026/tree/main/skills/telegram-bot
Command: npx skills add https://github.com/yandex-ai-studio/teen-museum-residence-2026 --skill telegram-bot-yandex-ai-studio

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyTelegramBotAPI, python-dotenv.

What problem does it solve? Building a Telegram bot from scratch involves repetitive boilerplate: project scaffolding, secret management, dependency setup, environment creation, and deployment configuration. This Skill automates the entire workflow so you get a working polling bot without manual setup errors. ## Core Features & Use Cases - Project Scaffolding: Generates a complete bot project with bot.py, requirements.txt, .env, .env.example, and .gitignore, keeping secrets out of version control. - Polling-Only Runtime: Implements handlers for commands, text messages, inline keyboards, and callback buttons using pyTelegramBotAPI with infinity_polling, no webhooks or web servers. - Cross-Platform Environment: Creates the virtual environment with uv and runs everything via uv run, working identically on Windows, macOS, and Linux. - Optional Server Deployment: On explicit request, deploys the bot to a remote server over SSH with systemd, nohup, or tmux for persistent operation. - Use Case: Ask for a bot that answers FAQs with inline buttons; the Skill scaffolds the project, collects your TELEGRAM_TOKEN, installs dependencies, launches the bot locally, and verifies it responds to /start. ## Quick Start Create a Telegram bot named museum-guide that answers questions with inline keyboard buttons and run it locally.

Frequently Asked Questions about telegram-bot

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Telegram bot with Python and telebot?

Install pyTelegramBotAPI and python-dotenv, store your TELEGRAM_TOKEN in a .env file, define message handlers with @bot.message_handler decorators, and start the bot with bot.infinity_polling(). This Skill scaffolds the entire project and runs it via uv.

How to add inline keyboard buttons to a Telegram bot?

Use InlineKeyboardMarkup and InlineKeyboardButton from telebot.types to attach buttons to messages, then handle taps with @bot.callback_query_handler. The callback handler should call answer_callback_query and can edit the original message text.

Can I run a Telegram bot without a webhook or web server?

Yes, polling mode with bot.infinity_polling() requires no web server, public URL, or SSL certificate. The bot continuously fetches updates from the Telegram API, making it suitable for local machines and simple server deployments.

Why does my Telegram bot show Conflict: can't use getUpdates while a webhook is active?

This error means a webhook is still registered for the bot, blocking polling. Remove it by calling https://api.telegram.org/bot<TOKEN>/deleteWebhook, then restart the bot in polling mode.

How do I deploy a Telegram bot to a remote server with systemd?

Copy the project files via scp, create the environment on the server with uv venv and uv pip install, then install a systemd unit with Restart=always pointing ExecStart at the venv Python. Enable it with systemctl enable --now and verify logs via journalctl.

Why is my Telegram bot not responding to messages in a group?

Group privacy mode likely blocks the bot from reading messages. Disable it through @BotFather with the /setprivacy command, and confirm the bot process is running without authorization errors in its logs.