🤖 Amin's Smart Telegram Bot

Powered by Docker, Ollama, Gemini AI & Advanced Integrations

🌟 Overview

Meet Amin's Smart Assistant - an intelligent Telegram bot that seamlessly integrates with Gmail, Google Drive, Google Sheets, and multiple AI models. This sophisticated automation workflow transforms your Telegram into a powerful command center for productivity and communication.

✨ Key Features

• 🧠 Dual AI Agents with specialized capabilities
• 📧 Gmail Integration - Send & receive emails through Telegram
• 📊 Google Sheets - View and manage spreadsheet data
• 🗃️ Google Drive - Access files and folder structures
• 💾 Memory System - Persistent conversation context
• 🐍 Python Support - Execute code with intelligent detection
• 🌐 Multi-Language - Supports English and Persian (فارسی)

🏗️ Architecture

graph TD
    A[Telegram Input] --> B{Message Type Detection}
    B -->|Email Related| C[AI Agent - Email]
    B -->|Data/Drive Related| D[AI Agent - Data]
    
    C --> E[Gmail Tools]
    C --> F[Gemini AI Model]
    
    D --> G[Google Sheets]
    D --> H[Google Drive]
    D --> I[Gemini AI Model]
    
    E --> J{Response Processing}
    G --> J
    H --> J
    
    J -->|Contains Python| K[Code Execution]
    J -->|Regular Response| L[Direct Output]
    
    K --> M[Telegram Output]
    L --> M
    
    F --> N[PostgreSQL Memory]
    I --> O[PostgreSQL Memory]

🛠️ Components & Integrations

🤖 AI Models

• Gemini 2.0 Flash - Advanced reasoning and code generation
• Qwen 3:4B - Fast local processing via Ollama
• Intelligent Model Selection - Automatic switching based on task complexity

📱 Telegram Integration

• Real-time messaging with webhook support
• Message filtering and intelligent routing
• Personalized responses with user name integration
• Emoji enhancement with meaningful yellow stickers 💛

🐳 Infrastructure Stack

• Docker & WSL2: Containerized deployment on Windows Subsystem for Linux
• ngrok: Secure tunneling for webhook endpoints
• Ollama: Local AI model serving with GPU acceleration
• PostgreSQL: Persistent memory and session management
• n8n: Core automation and workflow orchestration

📧 Gmail Capabilities

• Send emails through natural language commands
• Retrieve messages from inbox and sent folders
• Smart recipient detection with AI-powered email composition
• Automatic formatting and sender attribution

📊 Google Workspace

• Google Sheets: Read data, analyze spreadsheets, view specific rows/columns
• Google Drive: Search files, folder structures, storage analytics
• Seamless authentication with OAuth2 integration

🧠 Memory System

• PostgreSQL-backed conversation memory
• Context-aware responses across sessions
• Personalized interaction based on chat history

🚀 Quick Start

Prerequisites

• n8n instance (self-hosted or cloud)
• Telegram Bot Token
• Google OAuth2 credentials
• PostgreSQL database
• Ollama with WSL2 Docker integration
• ngrok for secure tunneling
• Docker running on WSL2

Installation

1. Setup WSL2 & Docker Environment

   # Install WSL2 with Ubuntu
   wsl --install -d Ubuntu
   
   # Install Docker in WSL2
   curl -fsSL https://get.docker.com -o get-docker.sh
   sudo sh get-docker.sh
   
   # Start Docker service
   sudo service docker start
   

2. Setup Ollama with Docker

   # Pull and run Ollama container
   docker run -d --gpus=all -v ollama:/root/.ollama -p 11434:11434 --name ollama ollama/ollama
   
   # Install Qwen model
   docker exec -it ollama ollama pull qwen3:4b
   

3. Setup ngrok for Tunneling

   # Install ngrok
   curl -s https://ngrok-agent.s3.amazonaws.com/ngrok.asc | sudo tee /etc/apt/trusted.gpg.d/ngrok.asc >/dev/null
   echo "deb https://ngrok-agent.s3.amazonaws.com buster main" | sudo tee /etc/apt/sources.list.d/ngrok.list
   sudo apt update && sudo apt install ngrok
   
   # Authenticate ngrok
   ngrok authtoken YOUR_NGROK_TOKEN
   
   # Expose n8n webhook
   ngrok http 5678
   

4. Deploy n8n with Docker

   # Create n8n container with PostgreSQL
   docker run -d \
     --name n8n \
     -p 5678:5678 \
     -e DB_TYPE=postgresdb \
     -e DB_POSTGRESDB_HOST=postgres \
     -e DB_POSTGRESDB_DATABASE=n8n \
     -v n8n_data:/home/node/.n8n \
     --link postgres:postgres \
     n8nio/n8n
   

5. Import Workflow

   # Import the workflow JSON into your n8n instance
   curl -X POST "your-ngrok-url.ngrok.io/api/v1/workflows/import" \
     -H "Content-Type: application/json" \
     -d @n8n_amin_workflow.json
   

6. Configure Credentials

   • Set up Telegram Bot API credentials with ngrok webhook URL
   • Configure Google OAuth2 for Gmail, Sheets, and Drive
   • Add PostgreSQL connection details
   • Configure Ollama API endpoint (http://localhost:11434)

7. Activate Workflow

   # Activate the workflow through n8n interface
   # Update Telegram webhook URL with ngrok endpoint
   # Ensure all nodes are properly connected
   

🔧 Configuration

Telegram Bot Setup

// Bot credentials configuration
{
  "telegramApi": {
    "accessToken": "YOUR_BOT_TOKEN",
    "baseURL": "https://api.telegram.org"
  }
}

Ollama Configuration

// Ollama API configuration for local AI models
{
  "ollamaApi": {
    "baseURL": "http://localhost:11434",
    "model": "qwen3:4b"
  }
}

ngrok Webhook Setup

// Telegram webhook with ngrok URL
{
  "webhookUrl": "https://your-tunnel.ngrok.io/webhook/telegram",
  "allowedUpdates": ["message"]
}

Docker Network Configuration

# Create custom network for service communication
docker network create n8n-network

# Connect all containers to the network
docker network connect n8n-network ollama
docker network connect n8n-network postgres
docker network connect n8n-network n8n

💬 Usage Examples

📧 Email Operations

💬 User: "Send an email to [email protected] about tomorrow's meeting"
🤖 Bot: "I'll compose and send that email for you! 📧
         
         ✅ Email sent successfully to [email protected]
         📋 Subject: Tomorrow's Meeting
         💛 All set, Amin!"

📊 Data Retrieval

💬 User: "Show me the latest data from my spreadsheet"
🤖 Bot: "Here's your spreadsheet data, Amin! 📊
         
         📈 Found 25 rows in 'Column' sheet
         💛 Data retrieved successfully
         🗂️ Last updated: Today"

🐍 Code Execution

💬 User: "Write a Python script to calculate fibonacci"
🤖 Bot: "Here's your Python code! 🐍
         
         [Code execution results]
         💛 Script executed successfully
         ⚡ Performance: Fast"

🎯 Advanced Features

🔍 Smart Message Detection

The bot intelligently routes messages based on content analysis:

• Email keywords: "message", "پیام", "messag"
• Python keywords: "python", "پایتون", "pyton"
• Context awareness for follow-up conversations

🌟 Response Enhancement

• Automatic emoji insertion with meaningful placement
• Personalized greetings using user's first name
• Signature addition: "𝑨𝒎𝒊𝒏 💛 𝑴𝒐𝒏𝒊𝒓𝒚"
• Clean output with thinking process removal

🔒 Security Features

• OAuth2 authentication for all Google services
• Secure credential storage in n8n
• Session-based memory with PostgreSQL encryption
• Webhook validation for Telegram integration

📈 Performance Metrics

🛡️ Troubleshooting

Common Issues

Issue: Bot not responding to messages

# Check webhook status
curl -X GET "https://api.telegram.org/bot{TOKEN}/getWebhookInfo"

# Verify n8n workflow is active
# Check Telegram trigger node configuration

Issue: Gmail authentication errors

# Refresh OAuth2 tokens
# Verify scopes in Google Console
# Check credential expiration

Issue: ngrok tunnel disconnected

# Restart ngrok with persistent connection
ngrok http 5678 --region=us --log=stdout

# Update Telegram webhook URL
curl -X POST "https://api.telegram.org/bot{TOKEN}/setWebhook" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://new-tunnel.ngrok.io/webhook/telegram"}'

Issue: Ollama model not responding

# Check Ollama container status
docker ps | grep ollama

# Restart Ollama container
docker restart ollama

# Test model availability
curl http://localhost:11434/api/generate -d '{"model":"qwen3:4b","prompt":"test"}'

Issue: WSL2 Docker problems

# Restart Docker service in WSL2
sudo service docker restart

# Check Docker version compatibility
docker --version

# Verify WSL2 integration
wsl --list --verbose

🔮 Future Enhancements

• 🎨 Rich media support (images, documents, voice)
• 🌍 Multi-language expansion (Arabic, Turkish, etc.)
• 📱 Mobile app integration via webhooks
• 🤖 Advanced AI capabilities with GPT-4 integration
• 📊 Analytics dashboard for usage metrics
• 🔗 Additional service integrations (Notion, Slack, etc.)

🤝 Contributing

We welcome contributions! Please follow these steps:

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Commit changes: git commit -m 'Add amazing feature'
4. Push to branch: git push origin feature/amazing-feature
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Author

Amin Moniry 💛

• 🐙 GitHub: https://github.com/Amin-moniry-pr7
• 📧 Email: [Contact via GitHub]
• 💼 Portfolio: [Check GitHub for more projects]

🙏 Acknowledgments

• n8n Community for the amazing automation platform
• Ollama Team for local AI model serving
• ngrok for secure tunneling solutions
• Docker & WSL2 for seamless containerization
• Google Cloud for robust API ecosystem
• Telegram for excellent bot API
• PostgreSQL for reliable data persistence

🖼️ Visual Showcase

n8n UI Preview: