Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/boshyxd/discordllm
Run state-of-the-art language models locally. Chat with AI using simple slash commands. Zero cloud, zero cost – just pure, home-brewed AI magic.
https://github.com/boshyxd/discordllm
ai artificial-intelligence chatbot discord-bot discord-py language-model llm local-llm machine-learning nlp ollama open-source python self-hosted
Last synced: about 2 months ago
JSON representation
Run state-of-the-art language models locally. Chat with AI using simple slash commands. Zero cloud, zero cost – just pure, home-brewed AI magic.
- Host: GitHub
- URL: https://github.com/boshyxd/discordllm
- Owner: boshyxd
- License: mit
- Created: 2024-06-23T03:29:06.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2024-06-23T21:03:48.000Z (7 months ago)
- Last Synced: 2024-06-24T06:04:02.167Z (7 months ago)
- Topics: ai, artificial-intelligence, chatbot, discord-bot, discord-py, language-model, llm, local-llm, machine-learning, nlp, ollama, open-source, python, self-hosted
- Language: Python
- Homepage:
- Size: 12.7 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# DiscordLLM 🤖💬
[](https://opensource.org/licenses/MIT)
[](https://www.python.org/downloads/release/python-380/)
[](https://discordpy.readthedocs.io/en/stable/)
[](https://ollama.ai/)
DiscordLLM is a powerful Discord bot that brings the capabilities of large language models right to your server, running entirely on your local machine. No cloud services, no API costs – just pure, home-brewed local AI at your fingertips.
## 🌟 Features
- Run state-of-the-art language models locally
- Interact with AI using simple Discord slash commands
- Zero cloud dependency, complete privacy
- Customizable and expandable
- Supports multiple LLM models (currently showcasing Qwen2 1.5B)
## 🚀 Quick Start
### Prerequisites
- Python 3.8 or higher
- [Discord Developer Account](https://discord.com/developers/applications)
- [Ollama](https://ollama.ai/) installed on your local machine
### Installation
1. Clone the repository:
```
git clone https://github.com/boshyxd/DiscordLLM.git
cd DiscordLLM
```
2. Install required dependencies:
```
pip install -r requirements.txt
```
3. Set up your Discord bot:
- Create a new application in the [Discord Developer Portal](https://discord.com/developers/applications)
- Add a bot to your application
- Copy the bot token
4. Configure the bot:
- Replace `YOUR_BOT_TOKEN` with your actual bot token
5. Install and run Ollama:
```
ollama run qwen2:1.5b
```
6. Start the bot:
```
python bot.py
```
## 💬 Usage
Once the bot is running and invited to your server, you can interact with it using slash commands:
- `/ask `: Ask the AI a question
Example:
```
/ask What is the capital of France?
```
## 🧠 Supported Models
Currently, DiscordLLM is configured to use the Qwen2 1.5B model, but it can be easily adapted to use any model supported by Ollama. To use a different model:
1. Download the model using Ollama:
```
ollama pull model_name
```
2. Update the `default_model` in `config.json`
## 🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
1. Fork the repository
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
## 📜 License
Distributed under the MIT License. See `LICENSE` for more information.
## 📞 Contact
Angus Bailey - [email protected]
Project Link: [https://github.com/boshyxd/DiscordLLM](https://github.com/boshyxd/DiscordLLM)
## 🙏 Acknowledgements
- [Discord.py](https://discordpy.readthedocs.io/)
- [Ollama](https://ollama.ai/)
- [Qwen2](https://huggingface.co/Qwen/Qwen1.5-0.5B)