Aripa

A powerful, open-source agentic Discord bot designed to help you securely and efficiently manage your community.

---

---

Links

• Marketing site: aripa.app
• Documentation: docs.aripa.app

Install

1. Go to the latest release.
2. Download the latest version and extract it.
3. Install dependencies:

bun install

4. Create or update your config:

bun run onboard

5. Start Aripa with your Discord bot token:

TOKEN="your-discord-bot-token" bun run start

For development with automatic reloads:

TOKEN="your-discord-bot-token" bun run dev

Configuration

bun run onboard opens the setup wizard for config.json. It configures the bot name, style prompt, allowlisted Discord servers, AI model providers, web search, and agent rate limits.

Common environment variables:

• TOKEN: required Discord bot token.
• PREFIX: text action prefix, defaults to -.
• DATABASE_PATH: SQLite database path, defaults to aripa.sqlite.
• CONFIG_PATH: config file path, defaults to config.json.
• OPENAI_API_KEY: used for OpenAI models.
• OPENROUTER_API_KEY: used for OpenRouter models.
• AI_GATEWAY_API_KEY: used for Vercel AI Gateway models.
• GOOGLE_GENERATIVE_AI_API_KEY: used for Gemini web-search features.

AI Cost Note

Aripa can call AI model providers when agents, summaries, or web-search features are enabled. Those requests may cost the developer or operator running the bot, depending on the provider, model, and API key used.