A Discord chatbot powered by DeepSeek API, featuring a built-in Isaac personality (a depressive, sarcastic, cynical robot) with autonomous responses, vision capabilities, and Python tool execution.

• Isaac Personality: Depressive, sarcastic, and cynical robot character
• Autonomous Responses: Bot naturally participates in conversations without being @mentioned
• Conversation Dominance Detection: Prevents bot from dominating conversations by tracking message ratios
• Vision Capability: Can see and describe images using OpenAI GPT-4o
• URL Summarization: Automatically summarizes shared links using Kagi Universal Summarizer
• Web Search: Answers questions about current events using Kagi FastGPT
• Web Fetch: Reads and extracts content from web pages
• Python Tool Integration: Executes Python code to solve problems and perform calculations
• Web Dashboard: Debug interface for viewing decisions, responses, and prompts
• SQLite Database: Tracks all messages, responses, and AI decisions

The bot monitors conversations and decides when to naturally chime in:

• Waits for conversation to settle (configurable debounce, default 15 seconds)
• Evaluates if there's something interesting to comment on
• Tracks its own message ratio to avoid dominating (backs off if >40% of recent messages)
• Direct @mentions always work regardless of ratio

When images are posted, the bot can see and understand them:

• Uses OpenAI GPT-4o for image analysis
• Descriptions are cached in the database
• Integrated into conversation context so the bot can reference images naturally

The bot can execute Python code to solve problems:

• "Write a response that's exactly 42 characters long" → Iteratively crafts and measures
• "What's 15% of $1,250 plus tax at 8.5%?" → Calculates precisely
• Multi-iteration refinement with reflection on previous attempts

When users share links, the bot automatically summarizes them:

• Uses Kagi Universal Summarizer for articles, YouTube videos, PDFs, and more
• Summaries are cached in the database and included in conversation context
• Bot can discuss shared links naturally without needing to fetch them again
• Skips Discord CDN links, images, and GIF services

The bot can search the web and read pages for current information:

• Web Search: Uses Kagi FastGPT to answer questions about current events, news, prices, etc.
• Web Fetch: Reads and extracts content from specific URLs using Mozilla Readability
• "What's the weather in Tokyo?" → Searches and returns current conditions
• "What's happening with [recent event]?" → Gets up-to-date information

• Node.js 20+
• Python 3 (for tool execution)
• Docker (optional, for containerized deployment)
• DeepSeek API Key (for chat responses)
• OpenAI API Key (optional, for vision capability)
• Kagi API Key (optional, for web search - requires Kagi subscription)
• Discord Bot Token

1. Clone and install:

git clone https://github.com/amiantos/impostor.git
cd impostor
npm install

2. Configure:

cp conf/config.json.example conf/config.json
# Edit conf/config.json with your API keys

3. Run:

# Development (with auto-restart)
npm run dev

# Production
npm start

# Docker
./start.sh    # Start
./stop.sh     # Stop

{
    "generator": {
        "deepseek": {
            "api_key": "<DEEPSEEK API KEY>",
            "base_url": "https://api.deepseek.com",
            "model": "deepseek-chat",
            "temperature": 0.9,
            "max_tokens": 500
        }
    },
    "bot": {
        "token": "<DISCORD BOT TOKEN>"
    },
    "channels": ["<CHANNEL_ID>"],
    "autonomous": {
        "enabled": true,
        "debounce_seconds": 15
    },
    "vision": {
        "enabled": true,
        "supported_formats": ["png", "jpg", "jpeg", "gif", "webp"],
        "max_file_size_mb": 20
    },
    "openai": {
        "api_key": "<OPENAI API KEY>",
        "model": "gpt-4o",
        "max_tokens": 300
    },
    "web": {
        "enabled": true,
        "port": 3000
    },
    "kagi": {
        "api_key": "<KAGI API KEY>"
    },
    "url_summarize": {
        "enabled": true,
        "summary_type": "takeaway",
        "max_urls_per_message": 3
    }
}

When enabled, access the dashboard at http://localhost:3000 to view:

• Recent AI decisions (should respond? why?)
• Bot responses with full prompt history
• Message database and vision descriptions

All data is stored in data/impostor.db (SQLite):

• Message history with attachments, vision descriptions, and URL summaries
• Bot responses and trigger messages
• AI decision logs with reasoning
• Full prompts for debugging

Inspired by notunderctrl/gpt-3.5-chat-bot.