Domain - OpenAI-Compatible Discord Chatbot

Domain is a feature-rich Discord chatbot powered by OpenAI-compatible APIs. It's designed to be highly configurable and extensible, offering a wide array of functionalities to enhance your Discord server.

Important

For people coming from SoM, since resources are limited and we have a whitelist where the bot works, we strongly encourage users to selfhost the bot

Features

• AI-Powered Conversations: Utilizes OpenAI-compatible APIs for intelligent and context-aware chat responses.
• Universal API Compatibility: Works with OpenAI, Ollama, OpenRouter, and other compatible providers.
• Smart Context Gathering: Employs sophisticated methods to understand conversation context for more relevant interactions.
• Reputation System: Allows users to build and track reputation within the server.
• Image Generation: Capable of generating images from SVG code.
• Vision Capabilities: Can understand and analyze uploaded images.
• User Moderation: Includes features for timing out users.
• Code Snippet Handling: Can understand and process snippets from code blocks.
• File & Picture Understanding: Ability to interpret and react to uploaded pictures and files.
• WebUI: A comprehensive web interface for:
  • Viewing logs.
  • Managing bans.
  • Viewing reputation.
  • Real-time server statistics.
• Customizable Prompts: Supports different prompts per channel for tailored bot behavior.
• Extensive Configuration: Highly configurable through the config.toml.
• Emoji Management: Resolves and utilizes custom emojis.
• Banned Site Filtering: Filters messages containing links to banned sites.
• Sleeping Mode: Can be set to be inactive during specified hours.
• Proxy Support: Allows routing traffic through proxies.
• Remote Blocklists: Can fetch and use remote domain blocklists.

Getting Started

Prerequisites

• Docker installed.
• A Discord Bot Token.
• An OpenAI API Key (or compatible provider API key).
• Linux: A Linux environment is recommended for running Domain, but it can also run on Windows or macOS with Docker.

Installation & Setup

1. Create a directory for Domain:

   mkdir domain
   cd domain

2. Create basic directories and files:

   mkdir data
   mkdir prompts
   touch config.toml

3. Copy the template configuration (Optional)
4. Copy docker-compose.yml to the directory
5. If you are not running it on Linux, you may want to remove /etc/timezone and /etc/localtime from the docker-compose.yml file to avoid timezone issues.
6. Start the bot with docker compose:

   docker compose up -d

Usage

Once the bot is running and configured for your channels, you can interact with it by mentioning one of its aliases. The bot will use the Gemini API to generate responses based on the conversation and its configured prompt for that channel.

Commands

The bot primarily interacts through natural language. However, some slash commands are available:

• /amibanned: Checks if the user is banned.
• /reputation: Checks user reputation.
• /reset: (Owner only) Resets bot's context history.
• /version: Displays the bot's version.
• /summarize: Returns the last summarization of the day.

(More commands might be available or under development.)

Configuration (config.toml)

The config.toml file holds all configuration settings for Domain. It is the primary and recommended way for initial setup and many ongoing adjustments, this section serves as a detailed reference for all available parameters. You might refer to this for advanced configurations or if you prefer manual editing.

API Provider Configuration

Domain supports any OpenAI-compatible API with advanced token management features:

Basic Configuration

• OPENAI_API_KEY: Your API key (single key or array)
• OPENAI_MODEL: The model to use (e.g., "gpt-4o", "gpt-4o-mini")
• OPENAI_BASE_URL: Custom API endpoint (optional)

Advanced Token Management

Domain supports multiple API tokens with automatic failover to handle rate limits and resource exhaustion:

Single Token:

OPENAI_API_KEY = "your-single-key"

Multiple Tokens (Recommended):

OPENAI_API_KEY = ["key-1", "key-2", "key-3"]

When one token hits rate limits or quota exhaustion, Domain automatically rotates to the next available token.

Component-Specific Configuration

Configure separate tokens and endpoints for different bot components:

• Search API: SEARCH_OPENAI_API_KEY, SEARCH_OPENAI_BASE_URL, SEARCH_OPENAI_MODEL
• Response Logic: SHOULDRESPOND_OPENAI_API_KEY, SHOULDRESPOND_OPENAI_BASE_URL, SHOULDRESPOND_OPENAI_MODEL
• Message Generation: Uses the main OPENAI_* settings

This allows you to:

• Use different providers for different features
• Distribute API usage across multiple accounts/tokens
• Maintain service availability even when some tokens are rate-limited

Supported Providers:

• OpenAI: Use https://api.openai.com/v1 (default)
• Ollama: Local models via http://localhost:11434/v1
• OpenRouter: Multiple models via https://openrouter.ai/api/v1
• Azure OpenAI: Azure-hosted OpenAI models
• Other compatible providers: Any API that implements OpenAI's chat completions format

Refer to template.config.toml for a full list of available options and their structure.

WebUI

Domain includes a powerful WebUI accessible via http://localhost:4500

Features of the WebUI:

• Dashboard: Overview of bot status and statistics.
• Logs: View real-time logs from the bot.
• Ban Management: View and manage banned users.
• Reputation Viewer: Inspect user reputations.
• System Controls: Access to functions like manual garbage collection (gc) or heap dumps for debugging.
• Real-time Stats: WebSocket-based live updates of bot and system performance.

Note: The WebUI is not secured by default. Do not expose the WEBUI_PORT to the public internet without implementing proper security measures (e.g., a reverse proxy with authentication).

Project Structure

The project is organized into several key directories:

• commands/: Slash command handlers.
• cronJobs/: Scheduled tasks.
• data/: Static data files and runtime data storage.
• eventHandlers/: Handlers for Discord events (message creation, etc.).
• functions/: Core bot logic and utility functions.
• initializers/: Scripts for setting up various components (Discord client, OpenAI client, state).
• prisma/: Prisma schema and migration files for database management.
• prompts/: Markdown or text files used as system prompts for the AI model.
• utils/: General utility scripts.
• webui/: Contains all files related to the Express.js based Web User Interface.
  • webui/api/: API endpoints for the WebUI.
  • webui/views/: EJS templates for rendering WebUI pages.
  • webui/css/, webui/js/: Static assets for the WebUI.

Contributing

Contributions are welcome! Please refer to the project's issue tracker on GitHub for areas where you can help. If you plan to add a new feature or make significant changes, please open an issue first to discuss your ideas.

License

This project is licensed under the GNU Affero General Public License v3.0 or later. See the LICENSE.md file for details.

Support

• Support Channel (Matrix): #domainsupport:anchietae.cc
• Wiki & Further Information: GitHub Wiki
• Issues: GitHub Issues