Hive Mind

A Discord bot that turns your community's conversations into a knowledge base - helping you answer questios with it, summarise it, create articles and more. Built with Claude 3.5 Sonnet, it archives, indexes, and makes sense of your community's collective intelligence.

Features

• 🧠 Answers questions about any past discussion, pulling from the community's entire conversation history
• 📚 Generates daily summaries of all community activity, organized by topic and relevance
• 🔍 Maintains a searchable archive of all messages, files, and media shared in the community
• 📝 Creates long-form articles and reports by synthesizing related discussions across channels
• 🤖 Automatically identifies important discussions, emerging topics, and connects related threads

Live Demo

Want to see it in action? Join the Banodoco Discord server to see the bot's daily summaries and features live!

Setup

Installation

1. Clone the repository:

git clone https://github.com/peteromallet/bndc-engine.git
cd bndc-engine

2. Install required dependencies:

pip install -r requirements.txt

3. Create a .env file with the following variables:

# Required Bot Configuration
DISCORD_BOT_TOKEN=your_discord_bot_token
ANTHROPIC_API_KEY=your_anthropic_api_key

# Main Configuration
GUILD_ID=your_server_id
PRODUCTION_SUMMARY_CHANNEL_ID=channel_id_for_summaries
CATEGORIES_TO_MONITOR=category_id1,category_id2
ADMIN_USER_ID=your_admin_user_id

# Development Configuration (optional)
DEV_GUILD_ID=dev_server_id
DEV_SUMMARY_CHANNEL_ID=dev_channel_id
DEV_CATEGORIES_TO_MONITOR=dev_category_ids
TEST_DATA_CHANNEL=test_channel_id

Running the Bot

Basic operation:

python main.py

Development mode:

python main.py --dev

Run summary immediately:

python main.py --run-now

Bot Permissions

The bot requires the following Discord permissions:

• Read Messages/View Channels
• Send Messages
• Create Public Threads
• Send Messages in Threads
• Manage Messages (for pinning)
• Read Message History
• Attach Files
• Add Reactions
• View Channel
• Manage Threads

Development Mode

Run the bot in development mode to:

• Use test data instead of live channels
• Test in a development server
• Avoid affecting production data

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Archive management commands:

# Archive specific channels or date ranges
python scripts/archive_discord.py --channel-id <channel_id> --start-date YYYY-MM-DD

# Clean up test or temporary data
python scripts/cleanup_test_data.py

# Migrate database schema
python scripts/migrate_db.py