PYTHON · DISCORD.PY · SQLITE

A complete AI Discord bot, mapped for launch.

Browse the working architecture, inspect every source file, and download a clean async starter you can run locally or deploy.

—project files

4Discord cogs

3async services

100%env configured

SYSTEM MAP

Small modules, clear boundaries.

Async all the way down

Discord edge

Slash commands, mentions, permissions, typing states, and readable embeds live in focused cogs.

cogs/

AI gateway

An OpenAI-compatible HTTP client adds timeouts, retry policy, provider configuration, and safe error messages.

services/ai_service.py

Persistent memory

SQLite keeps guild settings and per-user/channel conversations isolated, capped, expiring, and resettable.

database.py

Safety layer

Spam, blocked words, link filtering, warnings, and moderator logs run through explicit validated rules.

cogs/moderation.py

SOURCE EXPLORER

Inspect the project file by file.

Select a file from the project tree to inspect it.

LAUNCH CHECKLIST

From download to first response.

Configure secrets

Copy .env.example to .env. Add the Discord token, AI key, provider URL, and model. Never commit .env.

Invite with least privilege

Use bot and applications.commands scopes. Enable only Message Content, then grant Send Messages, Embed Links, Read History, and Moderate Members if needed.

Sync and test

Run the bot once to sync global commands, or set DEV_GUILD_ID for instant development sync. Watch logs for permission or intent errors.

Deploy safely

Use a worker on Railway, Render, Fly.io, or a small VPS. Mount persistent storage for SQLite and configure health-aware restarts.

Included in the kitReal Python modules, tests, environment template, README, moderation rules, and graceful shutdown handling.