telegram-praisonai-bot

Telegram bot powered by PraisonAI multi-agent framework.

Installation

pip install telegram-praisonai-bot

Quick Start

1. Create a Telegram Bot

   • Message @BotFather on Telegram
   • Send /newbot and follow the instructions
   • Copy the bot token

2. Start PraisonAI Server

   pip install praisonai
   praisonai serve agents.yaml --port 8080
   

3. Run the Bot

   export TELEGRAM_BOT_TOKEN=your_telegram_token
   export PRAISONAI_API_URL=http://localhost:8080
   telegram-praisonai-bot
   

   Or create a .env file:

   TELEGRAM_BOT_TOKEN=your_telegram_token
   PRAISONAI_API_URL=http://localhost:8080
   PRAISONAI_TIMEOUT=300
   

Commands

You can also just send a message directly and the bot will process it.

Usage Examples

/ask What are the latest trends in AI?
/agent researcher Research quantum computing
/agents

Programmatic Usage

from telegram_praisonai_bot.bot import PraisonAITelegramBot

bot = PraisonAITelegramBot(
    token="YOUR_TELEGRAM_TOKEN",
    api_url="http://localhost:8080",
    timeout=300
)
bot.run()

Using the Client Directly

import asyncio
from telegram_praisonai_bot import PraisonAIClient

async def main():
    client = PraisonAIClient(api_url="http://localhost:8080")
    
    # Run workflow
    result = await client.run_workflow("Research AI trends")
    print(result)
    
    # Run specific agent
    result = await client.run_agent("Write an article", "writer")
    print(result)
    
    # List agents
    agents = await client.list_agents()
    print(agents)

asyncio.run(main())

Configuration

Links

• PraisonAI Documentation
• PraisonAI GitHub
• python-telegram-bot Documentation

License

MIT