Quick Start
Set up Freesona in minutes — clone, configure, and launch your bot.
Configuration
Learn every environment variable and runtime setting you can tune.
Persona System
Create and manage bot personas with live editing and saved presets.
AI Providers
Switch between Gemini, OpenAI, Ollama, Groq, and more at runtime.
Command Reference
Browse every slash command and prefix command with permissions.
Moderation
Warn, kick, ban, timeout, and configure auto-punishment thresholds.
What Freesona Does
Freesona is a BYOK (Bring Your Own Key) Discord bot — you supply the API credentials, and the bot runs entirely on your host. There are no subscriptions, no credit limits, and no locked features.AI Persona
Edit personality, background, beliefs, and style through a Discord modal — changes apply instantly, no restart needed.
Long-term Memory
Freesona extracts facts about each user from conversations and injects them automatically into future prompts.
Autonomous Mode
The bot can join conversations on its own using a confidence-scored intent evaluator, not random chance.
Knowledge Base
Add documents to a local ChromaDB store and let the bot retrieve relevant context for every reply.
Media Tools
Download videos and audio, and separate vocals from instrumentals via MVSEP.
Moderation Suite
Full moderation toolkit with warnings, auto-threshold actions, and per-guild configuration.
Get Started in Three Steps
Clone and install
Clone the repository and install Python dependencies with
pip install -r requirements.txt.Configure your environment
Copy
.env.sample to .env, add your Discord bot token and at least one AI provider key.