> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fs.soquincy.qzz.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Freesona: Your Customizable Discord Bot

> Freesona is a free, self-hosted Discord bot you fully control — bring your own AI keys, shape the persona, and extend it however you like.

Freesona is a customizable, self-hosted Discord bot that puts you in control. Bring your own AI API keys (Gemini, OpenAI, Ollama, and more), shape the bot's personality with a live persona editor, and use moderation tools, media utilities, and a built-in knowledge base — all on infrastructure you own.

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/quickstart">
    Set up Freesona in minutes — clone, configure, and launch your bot.
  </Card>

  <Card title="Configuration" icon="gear" href="/configuration">
    Learn every environment variable and runtime setting you can tune.
  </Card>

  <Card title="Persona System" icon="masks-theater" href="/features/persona">
    Create and manage bot personas with live editing and saved presets.
  </Card>

  <Card title="AI Providers" icon="microchip-ai" href="/features/ai-providers">
    Switch between Gemini, OpenAI, Ollama, Groq, and more at runtime.
  </Card>

  <Card title="Command Reference" icon="terminal" href="/reference/commands">
    Browse every slash command and prefix command with permissions.
  </Card>

  <Card title="Moderation" icon="shield-halved" href="/guides/moderation">
    Warn, kick, ban, timeout, and configure auto-punishment thresholds.
  </Card>
</CardGroup>

## 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.

<CardGroup cols={3}>
  <Card title="AI Persona" icon="user-astronaut">
    Edit personality, background, beliefs, and style through a Discord modal — changes apply instantly, no restart needed.
  </Card>

  <Card title="Long-term Memory" icon="brain">
    Freesona extracts facts about each user from conversations and injects them automatically into future prompts.
  </Card>

  <Card title="Autonomous Mode" icon="robot">
    The bot can join conversations on its own using a confidence-scored intent evaluator, not random chance.
  </Card>

  <Card title="Knowledge Base" icon="database">
    Add documents to a local ChromaDB store and let the bot retrieve relevant context for every reply.
  </Card>

  <Card title="Media Tools" icon="photo-film">
    Download videos and audio, and separate vocals from instrumentals via MVSEP.
  </Card>

  <Card title="Moderation Suite" icon="gavel">
    Full moderation toolkit with warnings, auto-threshold actions, and per-guild configuration.
  </Card>
</CardGroup>

## Get Started in Three Steps

<Steps>
  <Step title="Clone and install">
    Clone the repository and install Python dependencies with `pip install -r requirements.txt`.
  </Step>

  <Step title="Configure your environment">
    Copy `.env.sample` to `.env`, add your Discord bot token and at least one AI provider key.
  </Step>

  <Step title="Run the bot">
    Launch with `python main.py` or use the included setup scripts for a guided local setup.
  </Step>
</Steps>

Ready to dive in? Follow the [Quickstart guide](/quickstart) for detailed step-by-step instructions.