botato 0.1.0

A modern and maintainable Discord bot framework for Python.

Botato

---

A modern, minimal, and well-documented Discord bot framework for Python. Built to fix everything the others got wrong.

📝 Table of Contents

• About
• Getting Started
• Deployment
• Usage
• Built Using
• TODO
• Contributing
• Authors
• Acknowledgments

😮 About

Botato is a Discord bot framework designed for developers who want clarity, simplicity, and reliability. Where other frameworks suffer from outdated docs, bloated abstractions, and lack of transparency, Botato provides a modern, well-typed, extensible alternative.

It includes a dynamic Gateway client, a fast REST API wrapper, JSON-driven intent management, and typed data models powered by Pydantic.

🏁 Getting Started

These instructions will get you a copy of the project up and running locally for development and testing.

Prerequisites

• Python 3.10+
• Poetry (https://python-poetry.org/docs/)
• A Discord bot token

Installing

Clone the repo and install dependencies:

poetry install

Activate the environment:

poetry env activate

Run the example bot:

DISCORD_TOKEN=your-token-here poetry run python examples/basic_bot.py

🔧 Running the tests

To run the test suite:

poetry run pytest

🎈 Usage

Register events with decorators:

@bot.event
async def on_message_create(data):
    print(data["content"])

🚀 Deployment

For production usage, you can use a process manager like systemd, supervisord, or pm2 (for cross-platform Python apps).

Make sure to secure your token using environment variables or secret managers.

⛏️ Built Using

• Python - Language
• aiohttp - Async HTTP client
• websockets - Gateway support
• pydantic - Data validation
• loguru - Logging

✍️ Authors

• @shivkun - Project lead and developer

🎉 Acknowledgements

• Discord API team & community docs
• discord.py for inspiration (and showing us what not to do)
• Contributors and early testers