Local LLM Discord Bot

🤖 Chat with your local LLM through Discord! Access your Ollama or LM Studio LLM from your phone, tablet, or any device with Discord.

✨ Features

• 🦙 Works with Ollama & LM Studio - Use your favorite local LLM
• 💬 Natural Chat Interface - DM the bot directly or mention it in servers
• 🛡️ Optional Moderation - OpenAI's free content filter
• 🔒 User Whitelisting - Control who can access your LLM
• 👥 Smart Context Management - Automatic single/multi-user modes
• 💾 Saves Your Setup - Configure once, use forever
• 🧠 Conversation Memory - Smart context window that shifts as needed
• 🖼️ Vision Model Support - Send images to vision-capable models
• 📝 Chat Logging - Save conversations for fine-tuning datasets
• 👍 RLHF Data Collection - Log user feedback for reinforcement learning

🚀 Quick Start

Prerequisites

• Windows PC with Python 3.10+
• Ollama or LM Studio installed with at least one model
• Discord account

Installation

git clone https://github.com/ella0333/Local-LLM-Discord-Bot.git
cd Local-LLM-Discord-Bot
pip install -r requirements.txt
python main.py

The setup wizard will walk you through everything! Just follow the prompts to configure your bot.

📖 Full Setup Guide

For detailed instructions including Discord bot creation, whitelisting, and optional features to support your fine tuning pipeline, check out the full setup guide linked above.

💬 How to Use on Discord

Once set up, you can chat with your LLM like another user:

• In Discord Servers: Mention @BotName or reply to its messages
• In DMs: Right-click the bot in a server → "Message" to start a DM
• With Images: Feel free to send images to vision models!

The bot responds naturally - no commands needed! Though /chat, /clear, /status and /help are available if you prefer.

🆘 Troubleshooting

Having issues? Check out the Troubleshooting Guide for solutions to common problems.

☕ Support the Developer

Created with ❤️ by Gabriella Baris - Check out my portfolio for more projects and tools!

If Local LLM Discord Bot has been helpful for accessing your AI on the go, consider buying me a coffee! Your support helps keep this project alive and enables continued development of new features.

📚 Contact & Support

If you have any issues, find bugs, or need assistance, please open a GitHub issue:

• Technical support
• Feature requests
• Bug reports
• General questions

📄 License

MIT License - Free to use and modify!

🙏 Credits

• Ollama - Local LLM runner
• LM Studio - LLM interface
• discord.py - Discord API wrapper
• OpenAI - Moderation API