M Milo
GitHub

Open-Source Discord Bot

Support, moderation & ops in one bot.

Built for communities that want self-hosted tooling. Moderation, announcements, reminders, AI support, and workflows in one compact codebase.

View Source Quick Start
242 Stars
MIT License
3.9+ Python
AI

AI-Assisted Support

Chat with model allowlists, web search, daily caps, and per-server policy controls.

MOD

Moderation

Warnings, invite filters, link filters, blocked words, and mod-log workflows.

Quick Start

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.py
OPS

Community Ops

Welcome flows, goodbye messages, announcements, reminders, and utility commands.

OSS

Open Source

MIT licensed, contributor docs included, small enough to actually extend.

Getting Started

Three steps to running.

01

Clone

Pull the public repo. Configure secrets via .env or local config.

02

Configure

Set your Discord token and optional API keys before starting the bot.

03

Extend

Commands are split into cogs. Add or remove features independently.

Modules

Organized by concern.

Community

Welcome and goodbye flows, scheduled announcements, reminders, AFK handling.

  • Announcements & recurring reminders
  • Welcome and mod-log events
  • Server utility commands

Moderation

Policies for safer communities without a full enterprise panel.

  • Warnings and warning history
  • Invite and link filtering
  • Bad-word checks & whitelists

AI Support

AI chat, config controls, optional web search, per-server constraints.

  • Per-guild policies & cooldowns
  • Model allowlists & usage caps
  • Context isolation between users

Documentation

For contributors and admins.

Overview

README

Project summary, setup flow, features, and deployment notes.

→ Reference

Commands

Full command reference across AI, moderation, reminders, economy.

→ Ops

Deployment

Process expectations, storage notes, hosting guidance.

→ Community

Contributing

Contribution flow, review expectations, collaboration guidelines.

→

FAQ

Common questions.

Is Milo only a fun bot?

No. Entertainment features exist, but the core value is community support and operations.

Does it need a hosted backend?

No. It runs as a self-hosted process. No SaaS dependency.

Who should use it?

Open-source communities, study groups, volunteer-run servers, and maintainers who want practical tooling.

Can I extend it?

Yes. Commands are organized into cogs. Add your own or modify existing ones.