Open-Source Discord Community Platform
Run support, moderation, reminders, and server operations from one bot.
Milo is designed for open-source communities, study groups, and small servers that want self-hosted tooling instead of a black-box bot. It combines moderation, announcements, reminders, AI support, and server workflows in one compact codebase.
Server overview
Keep daily operations readable and predictable.
Welcome flows, scheduled announcements, AI chat controls, moderation rules, and recurring reminders all live in one maintainable bot.
AI Chat
Per-server controls Cooldowns, role rules, channel rules, usage capsModeration
Warnings and automod Invite filter, link filter, bad words, mod logCommunity
Announcements and reminders Scheduled messages, recurring reminders, AFK stateHosting
Self-hosted stack discord.py, SQLite, aiohttp, Pages for public docsCapabilities
The layout is inspired by modern bot product sites, but the product story stays Milo’s.
AI-Assisted Support
Optional chat with model allowlists, web search, daily caps, and per-server policy controls.
Moderation
Warnings, invite filters, link filters, blocked words, and mod-log-aware workflows.
Community Operations
Welcome flows, goodbye messages, scheduled announcements, reminders, and server utility commands.
Open Source by Default
MIT licensed, contributor docs included, and small enough for maintainers to actually extend.
Quick Start
Get a project page, public docs, and the bot itself online fast.
The homepage is designed like a product landing page, while the repo still contains the operational docs maintainers need.
Run Milo locally
git clone https://github.com/msgaxzzz/Milo-discord-fun-bot.git
cd Milo-discord-fun-bot
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python3 main.pyClone the repository
Start from the public repo and configure local secrets with `.env` or local config.
Configure runtime secrets
Set your Discord token and any optional API keys before starting the bot process.
Extend the bot by module
Commands are split into cogs, so moderation, reminders, and AI features remain easy to evolve.
Core Modules
Organized like a real product, not just a command dump.
Community Layer
Welcome and goodbye flows, scheduled announcements, reminders, AFK handling, and help surfaces.
- Announcements and recurring reminders
- Welcome and mod-log-aware events
- Server-facing utility commands
Moderation Layer
Policies for safer communities without turning the bot into a full enterprise panel.
- Warnings and warning history
- Invite and link filtering
- Bad-word checks and whitelist channels
Support Layer
AI chat, configuration controls, optional web search, and operational constraints per server.
- Per-guild policies and cooldowns
- Model allowlists and usage caps
- Context isolation between users
Docs and Links
Public entry points for contributors, reviewers, and server maintainers.
Overview
README
Project summary, setup flow, feature direction, and deployment notes.
ReferenceCommands
Full command reference across AI chat, moderation, reminders, economy, and farming.
OpsDeployment
Long-running process expectations, storage notes, and practical hosting guidance.
CommunityContributing
Contribution flow, review expectations, and repo-level collaboration guidelines.
FAQ
Short answers for reviewers and maintainers.
Is Milo only a fun bot?
No. Entertainment features exist, but the stronger product story is community support and operations.
Does Milo require a hosted backend?
No. The bot runs as a self-hosted long-lived process and does not require a hosted SaaS backend.
Who should use it?
Open-source communities, study groups, volunteer-run servers, and maintainers who need practical tooling.
Why this UI direction?
It presents Milo like a maintainable technical product with docs and modules, instead of a random bot homepage.