Einstein Bot System

Einstein Bot is a powerful multi-platform AI assistant built for Telegram and Discord. It combines AI chat, media download, web automation, utilities, and system-control features in one smart bot experience.

✨ What this bot can do

Einstein Bot includes a wide range of features such as:

• 🤖 AI chat with OpenAI, Ollama, or demo mode
• 🎬 Video and audio downloading from supported sources
• 🎵 Music search and MP3 extraction
• 📺 YouTube search and trending video discovery
• 🖼️ Image-based tools, including pixel-art conversion and vision analysis
• 🎨 AI image and video generation support
• 🌐 Web search, browser automation, and website screenshots
• 🌤️ Weather lookup and quick information tools
• 📝 Notes management and reminder/alarm scheduling
• 📸 Desktop and web screenshots
• 📁 Workspace and file management utilities
• 🛠️ GitHub, Google, Gmail, and translation helpers
• ☁️ Cloudflare tunnel management for remote access
• 📱 Phone-control style utilities and remote dashboard actions
• 💬 Telegram and Discord integration for multi-platform use

🧠 Core capabilities

AI assistant

• Chat with the bot directly
• Use /ai for AI-powered replies
• Optional support for Ollama local models
• Optional support for OpenAI API

Media and download tools

• Download videos from supported links
• Extract audio as MP3
• Search YouTube quickly
• Download playlists
• Convert video clips to GIF
• Enhance media quality and process images

Productivity and utilities

• Create and manage notes
• Set reminders and alarms
• Track workspace files
• Take screenshots
• Manage downloads and uploads
• Access a utility dashboard

Automation and web tools

• Browse pages and take screenshots
• Search the web
• Check weather conditions
• Translate text
• Use GitHub tools
• Run browser-based automation commands

📋 Main commands

Some of the most useful commands are:

• /start - Start or wake up the bot
• /help - Show available commands
• /status - Check bot/system status
• /video - Download a video
• /music - Search or download audio
• /yt - Search YouTube
• /playlist - Download a playlist
• /ai - Chat with the AI assistant
• /ollama - Use local Ollama AI
• /weather - Get weather information
• /browser - Control browser tasks
• /screenshot - Capture screenshots
• /notes - Manage notes
• /remind - Set reminders
• /tunnel - Manage Cloudflare tunnel access
• /github - GitHub-related operations
• /translate - Translate text

🚀 Quick start

1. Install Python dependencies:

   pip install -r requirements.txt

2. Create a configuration file from the example environment file and add your tokens:

   copy .env.example .env

3. Start the bot:

   python bot.py

4. Open the local web panel at:

   http://127.0.0.1:18789
   

⚙️ Environment variables

The bot can use several optional environment variables for extra features:

• TELEGRAM_BOT_TOKEN
• DISCORD_BOT_TOKEN
• OPENAI_API_KEY
• USE_OLLAMA
• OLLAMA_MODEL
• WEATHER_API_KEY
• YOUTUBE_API_KEY
• GITHUB_TOKEN
• GITHUB_TOKEN_2

🧰 Requirements

This project uses Python and several libraries for Telegram, Discord, AI integrations, media processing, and automation.

📌 Notes

• Some features require valid API keys or external services.
• Optional tools like Ollama, browser automation, and Cloudflare tunneling may need additional setup.
• The bot is designed for experimentation, automation, and community use.

🤝 Contribution

Contributions are welcome. If you want to improve the bot, add more features, or improve documentation, feel free to open a pull request.