Run an AI-powered Discord bot from the comfort of your laptop.

bot discord discord-bot discord-py llm ollama python python3

Go to file

Chris Nutter 9e94811d81 updated python		2024-05-10 11:40:32 -07:00
.gitignore	Initial commit	2023-07-30 12:43:45 -07:00
Dockerfile	updated python	2024-05-10 11:40:32 -07:00
LICENSE	Initial commit	2023-07-30 12:43:45 -07:00
Modelfile	Update Modelfile	2024-02-02 15:09:40 -08:00
README.md	Update README.md	2023-11-01 15:16:18 -07:00
compose.yaml	Update README.md	2023-11-01 15:16:18 -07:00
discollama.py	Update discollama.py	2024-05-10 11:39:13 -07:00
poetry.lock	set keep_alive to keep forever	2024-02-02 14:50:13 -08:00
pyproject.toml	use ollama client	2024-01-12 13:34:12 -08:00

README.md

discollama

discollama is a Discord bot powered by a local large language model backed by Ollama.

Dependencies

Docker and Docker Compose

Run `discollama.py`

DISCORD_TOKEN=xxxxx docker compose up

Note: You must setup a Discord Bot and set environment variable DISCORD_TOKEN before discollama.py can access Discord.

discollama.py requires an Ollama server. Follow the steps in jmorganca/ollama repository to setup Ollama.

By default, it uses 127.0.0.1:11434 which can be overwritten with OLLAMA_HOST.

Note: Deploying this on Linux requires updating network configurations and OLLAMA_HOST.

Customize `discollama.py`

The default LLM is mike/discollama. A custom personality can be added by changing the SYSTEM instruction in the Modelfile and running ollama create:

ollama create mymodel -f Modelfile

This can be changed in compose.yaml:

environment:
  - OLLAMA_MODEL=mymodel

See jmorganca/ollama for more details.

Activating the Bot

Discord users can interact with the bot by mentioning it in a message to start a new conversation or in a reply to a previous response to continue an ongoing conversation.