latte
6a9b6fdda2
- Add searxng.py service for web queries via SearXNG API - Integrate search into ai_chat.py with AI-driven search decisions - AI determines if query needs current info, then searches automatically - Add SEARXNG_URL, SEARXNG_ENABLED, SEARXNG_MAX_RESULTS config options - Update documentation in README.md, CLAUDE.md, and .env.example
164 lines
4.7 KiB
Markdown
164 lines
4.7 KiB
Markdown
# Discord AI Bot
|
|
|
|
A customizable Discord bot that responds to @mentions with AI-generated responses. Supports multiple AI providers.
|
|
|
|
## Features
|
|
|
|
- **Multi-Provider AI**: Supports OpenAI, OpenRouter, Anthropic (Claude), and Google Gemini
|
|
- **Web Search**: Access current information via SearXNG integration
|
|
- **Fully Customizable**: Configure bot name, personality, and behavior
|
|
- **Conversation Memory**: Remembers context per user
|
|
- **Easy Deployment**: Docker support included
|
|
|
|
## Quick Start
|
|
|
|
### 1. Clone the repository
|
|
|
|
```bash
|
|
git clone https://github.com/your-username/discord-ai-bot.git
|
|
cd discord-ai-bot
|
|
```
|
|
|
|
### 2. Configure the bot
|
|
|
|
```bash
|
|
cp .env.example .env
|
|
```
|
|
|
|
Edit `.env` with your settings (see [Configuration](#configuration) below).
|
|
|
|
### 3. Run with Docker
|
|
|
|
```bash
|
|
docker compose up -d
|
|
```
|
|
|
|
Or run locally:
|
|
|
|
```bash
|
|
python -m venv .venv
|
|
source .venv/bin/activate
|
|
pip install -r requirements.txt
|
|
python -m daemon_boyfriend
|
|
```
|
|
|
|
## Configuration
|
|
|
|
All configuration is done via environment variables in `.env`.
|
|
|
|
### Required Settings
|
|
|
|
| Variable | Description |
|
|
|----------|-------------|
|
|
| `DISCORD_TOKEN` | Your Discord bot token |
|
|
| `AI_PROVIDER` | `openai`, `openrouter`, `anthropic`, or `gemini` |
|
|
| `OPENAI_API_KEY` | OpenAI API key (if using OpenAI) |
|
|
| `OPENROUTER_API_KEY` | OpenRouter API key (if using OpenRouter) |
|
|
| `ANTHROPIC_API_KEY` | Anthropic API key (if using Anthropic) |
|
|
| `GEMINI_API_KEY` | Google Gemini API key (if using Gemini) |
|
|
|
|
### Bot Identity
|
|
|
|
| Variable | Default | Description |
|
|
|----------|---------|-------------|
|
|
| `BOT_NAME` | `AI Bot` | The bot's display name (used in responses) |
|
|
| `BOT_PERSONALITY` | `helpful and friendly` | Personality traits for the AI |
|
|
| `BOT_DESCRIPTION` | `I'm an AI assistant...` | Shown when mentioned without a message |
|
|
| `BOT_STATUS` | `for mentions` | Status message (shown as "Watching ...") |
|
|
| `SYSTEM_PROMPT` | (auto-generated) | Custom system prompt (overrides default) |
|
|
|
|
### AI Settings
|
|
|
|
| Variable | Default | Description |
|
|
|----------|---------|-------------|
|
|
| `AI_MODEL` | `gpt-4o` | Model to use |
|
|
| `AI_MAX_TOKENS` | `1024` | Maximum response length |
|
|
| `AI_TEMPERATURE` | `0.7` | Response creativity (0.0-2.0) |
|
|
| `MAX_CONVERSATION_HISTORY` | `20` | Messages to remember per user |
|
|
|
|
### Web Search (SearXNG)
|
|
|
|
| Variable | Default | Description |
|
|
|----------|---------|-------------|
|
|
| `SEARXNG_URL` | (none) | SearXNG instance URL |
|
|
| `SEARXNG_ENABLED` | `true` | Enable/disable web search |
|
|
| `SEARXNG_MAX_RESULTS` | `5` | Max search results to fetch |
|
|
|
|
When configured, the bot automatically searches the web for queries that need current information (news, weather, etc.).
|
|
|
|
### Example Configurations
|
|
|
|
**Friendly Assistant:**
|
|
```env
|
|
BOT_NAME=Helper Bot
|
|
BOT_PERSONALITY=friendly, helpful, and encouraging
|
|
BOT_DESCRIPTION=I'm here to help! Ask me anything.
|
|
BOT_STATUS=ready to help
|
|
```
|
|
|
|
**Technical Expert:**
|
|
```env
|
|
BOT_NAME=TechBot
|
|
BOT_PERSONALITY=knowledgeable, precise, and technical
|
|
BOT_DESCRIPTION=I'm a technical assistant. Ask me about programming, DevOps, or technology.
|
|
BOT_STATUS=for tech questions
|
|
```
|
|
|
|
**Custom System Prompt:**
|
|
```env
|
|
BOT_NAME=GameMaster
|
|
SYSTEM_PROMPT=You are GameMaster, a Dungeon Master for text-based RPG adventures. Stay in character, describe scenes vividly, and guide players through exciting quests. Use Discord markdown for emphasis.
|
|
```
|
|
|
|
## Discord Setup
|
|
|
|
1. Go to [Discord Developer Portal](https://discord.com/developers/applications)
|
|
2. Create a new application
|
|
3. Go to **Bot** and create a bot
|
|
4. Enable these **Privileged Gateway Intents**:
|
|
- Server Members Intent
|
|
- Message Content Intent
|
|
5. Copy the bot token to your `.env` file
|
|
6. Go to **OAuth2** → **URL Generator**:
|
|
- Select scope: `bot`
|
|
- Select permissions: `Send Messages`, `Read Message History`, `View Channels`
|
|
7. Use the generated URL to invite the bot to your server
|
|
|
|
## Usage
|
|
|
|
Mention the bot in any channel:
|
|
|
|
```
|
|
@YourBot what's the weather like?
|
|
@YourBot explain quantum computing
|
|
@YourBot help me write a poem
|
|
```
|
|
|
|
## AI Providers
|
|
|
|
| Provider | Models | Notes |
|
|
|----------|--------|-------|
|
|
| OpenAI | gpt-4o, gpt-4-turbo, gpt-3.5-turbo | Official OpenAI API |
|
|
| OpenRouter | 100+ models | Access to Llama, Mistral, Claude, etc. |
|
|
| Anthropic | claude-3-5-sonnet, claude-3-opus | Direct Claude API |
|
|
| Gemini | gemini-2.0-flash, gemini-1.5-pro | Google AI API |
|
|
|
|
## Project Structure
|
|
|
|
```
|
|
src/daemon_boyfriend/
|
|
├── bot.py # Main bot class
|
|
├── config.py # Configuration
|
|
├── cogs/
|
|
│ └── ai_chat.py # Mention handler
|
|
└── services/
|
|
├── ai_service.py # AI provider factory
|
|
├── providers/ # AI providers
|
|
├── conversation.py # Chat history
|
|
└── searxng.py # Web search service
|
|
```
|
|
|
|
## License
|
|
|
|
MIT
|