pigeon-bot 0.1.0

A Python library for interacting with Pigeon Messenger

Pigeon Bot Python

A Python library for building chat bots on the Pigeon Messenger.

Installation

pip install pigeon-bot

Quick Start

import asyncio
import os
from pigeon_bot import Client, ClientConfig

async def main():
    token = os.getenv("BOT_TOKEN")
    if not token:
        print("Please set your bot token in the BOT_TOKEN environment variable")
        return

    config = ClientConfig(
        token=token,
        base_url="http://localhost",
        ws_url="ws://localhost/api/v1/ws"
    )
    client = Client(config)

    @client.on_event("ready")
    async def on_ready():
        print("bot is ready!")

    @client.on_event("new_message")
    async def on_new_message(message):
        if "hello" in message.content.lower():
            await message.reply("hi")

    await client.connect()

if __name__ == "__main__":
    asyncio.run(main())

Configuration

class ClientConfig:
    token: str
    base_url: Optional[str] = "http://localhost:8000"
    ws_url: Optional[str] = None
    auto_reconnect: bool = True
    reconnect_interval_ms: int = 5000

Base Events

• ready: Fires when the bot connects successfully
• authenticated: Fires after successful authentication
• new_message: Triggered on new messages
• error: Emitted on connection/authentication errors

License

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