# Freesona

## Docs

- [Freesona changelog and release notes](https://docs.fs.soquincy.qzz.io/changelog/overview.md): Track new features, updates, and fixes shipped to Freesona — including AI providers, ChromaDB knowledge base, memory, and moderation.
- [Configure Freesona: .env File and Runtime /config](https://docs.fs.soquincy.qzz.io/configuration.md): Set up your .env file and use runtime /config commands to tune every Freesona behavior — from AI provider selection to timing constants.
- [Connect AI Providers and Models to Your Bot](https://docs.fs.soquincy.qzz.io/features/ai-providers.md): Freesona supports Gemini, OpenAI, Ollama, NVIDIA NIM, Azure AI Foundry, Groq, and OpenRouter. Switch providers at runtime without restarting.
- [Autonomy Mode: Confidence-Scored Auto Replies](https://docs.fs.soquincy.qzz.io/features/autonomy.md): Freesona's autonomous mode uses a confidence-scored intent evaluator — not random chance — to decide when to chime in on conversations.
- [Knowledge Base: ChromaDB Retrieval for AI Context](https://docs.fs.soquincy.qzz.io/features/knowledge-base.md): Add documents to Freesona's ChromaDB knowledge base and let the bot retrieve relevant context automatically during every AI generation call.
- [Media: yt-dlp Downloads and MVSEP Vocal Separation](https://docs.fs.soquincy.qzz.io/features/media.md): Use Freesona to download video and audio from any yt-dlp supported URL, or separate vocals and instrumentals with MVSEP — all from Discord.
- [Short-Term and Long-Term Memory](https://docs.fs.soquincy.qzz.io/features/memory.md): Freesona extracts and stores facts about each user from conversations, then injects them into future prompts — automatically and per user.
- [Persona Editor: Shape Your Bot's Voice and Style](https://docs.fs.soquincy.qzz.io/features/persona.md): Use Freesona's structured persona editor to define personality, background, beliefs, and style — changes apply live without restarting the bot.
- [Extending Freesona with Custom Cog Modules](https://docs.fs.soquincy.qzz.io/guides/extending.md): Freesona is built to be extended. Add new cog modules, register them in the module system, and toggle them at runtime without restarting.
- [Hosting Freesona: Local, Docker, Railway, and Render](https://docs.fs.soquincy.qzz.io/guides/hosting.md): Deploy Freesona locally with setup scripts, containerize it with Docker, or push it to Railway or Render for managed cloud hosting.
- [Moderation: Warn, Kick, Ban, Timeout, and Purge](https://docs.fs.soquincy.qzz.io/guides/moderation.md): Use Freesona's moderation commands to warn, kick, ban, timeout, and purge — with configurable auto-threshold actions for warnings.
- [Freesona Module Management: Enable and Disable at Runtime](https://docs.fs.soquincy.qzz.io/guides/modules.md): Freesona's optional modules can be toggled on or off without restarting the bot. Use /module commands to manage them from Discord.
- [RSS and Atom Feed Monitoring in Discord Channels](https://docs.fs.soquincy.qzz.io/guides/rss-feeds.md): Configure Freesona to auto-post RSS and Atom feed updates to a Discord channel, or browse feed headlines on demand with slash commands.
- [Introduction to Freesona: BYOK Self-Hosted Discord Bot](https://docs.fs.soquincy.qzz.io/introduction.md): Freesona is a free, open-source Discord bot you self-host. Bring your own AI keys, customize the persona, and run it on your infrastructure.
- [Freesona Quickstart: Get Your Bot Online Fast](https://docs.fs.soquincy.qzz.io/quickstart.md): Set up a self-hosted Freesona bot from scratch: create a Discord application, configure your .env, and make your first command work.
- [Commands Reference: Slash and Prefix Command Index](https://docs.fs.soquincy.qzz.io/reference/commands.md): Complete reference for all Freesona slash and prefix commands — organized by category with syntax, aliases, and required permissions.
- [Freesona Environment Variables: Setup and Configuration](https://docs.fs.soquincy.qzz.io/reference/environment-variables.md): Every environment variable Freesona reads from .env — required credentials, AI provider keys, optional integrations, and file paths.
- [Runtime Config Reference: config.json Keys and Defaults](https://docs.fs.soquincy.qzz.io/reference/runtime-config.md): Every configurable key in Freesona's runtime config.json — what it controls, its type, default value, and the /config command to change it.
- [Troubleshooting Common Freesona Errors and Failures](https://docs.fs.soquincy.qzz.io/reference/troubleshooting.md): Fix the most common Freesona issues — bot won't start, commands not responding, AI errors, timezone problems, and media download failures.