Welcome to BotBox

Forget the boring parts. Make building bots fun!

What is BotBox?

BotBox is a Golang-powered CLI tool for scaffolding, configuring, and managing Discord bot projects using discord.py.
It’s designed to help you:

• Generate new bot projects instantly
• Add, remove, and manage cogs (modular bot features)
• Sync and upgrade configs with a single command
• Automate the boring stuff, so you can focus on your bot’s personality

Who is it for?

• Python developers who want to skip boilerplate and focus on features
• Discord bot creators who want a modular, maintainable project structure
• Anyone who loves CLIs and wants to build bots the right way

Why use BotBox?

• Zero boilerplate: Start with a working, modern Discord bot in seconds.
• Cog-based: Add or remove features as modular “cogs”—no more spaghetti code.
• Config made easy: Manage both global and project settings with simple commands.
• Automatic upgrades: Keep your project up-to-date with the latest schema.
• Fun, interactive CLI: Powered by Bubble Tea and Huh for a beautiful TUI experience.
• Headless when you need it: Every command runs from flags with no TUI, so BotBox works in scripts and CI.
• Modal commands: Generate slash commands that open a Discord popup form with up to five text inputs.
• Logging built in: Generated bots ship a logger with file rotation and console output, tuned with LOG_LEVEL and LOG_DIR.

What can I do with BotBox?

• Create a new bot project in seconds
• Add new cogs (features/commands) interactively
• Add modal commands that collect input through a popup form
• Remove cogs safely (auto-updates config)
• Sync config with your codebase
• Upgrade old projects to the latest config format
• Manage environment variables (supports .env and Doppler)
• Customize global and local settings for your workflow
• Script all of it from flags in headless mode

See it in action

Next Steps

• Installation
• Quick Start
• Headless Mode
• Project Structure
• Configuration
• Cogs Overview
• Troubleshooting