Fishie setup

This repository keeps the bot source in src, database migrations in migrations, and the Docker setup in the repository root.

What you need

• Docker Engine with the Compose plugin
• Git
• A Discord application and bot from the Discord Developer Portal
• PostgreSQL 18 if you are running outside Docker
• Python 3.13 and FFmpeg if you are running outside Docker

Copy examples/config.toml to config.toml and fill in the values you plan to use. config.toml is ignored by Git and should stay private.

The Discord bot token comes from the Bot page in the Discord Developer Portal. The application ID and client secret come from the OAuth2 page. Enable the gateway intents Fishie uses on the Bot page before inviting it.

Most third-party keys are optional until you use their related commands:

• Last.fm keys come from Last.fm API accounts
• Spotify keys come from the Spotify developer dashboard
• AniList keys come from the developer section in AniList settings
• Twitch keys come from the Twitch developer console
• Google keys come from the Google Cloud console
• Steam keys come from the Steam Web API key page

Create .env from .env.example. Use a long random PostgreSQL password and generate the credential key with:

python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"

Do not commit .env, config.toml, cookie files, logs, or credential keys.

Run with Docker

The regular Compose file starts PostgreSQL, applies migrations, and then starts Fishie:

docker compose up -d --build
docker compose ps
docker compose logs -f fishie

Restart the bot with:

docker compose restart fishie

Stop everything with:

docker compose down

The production Compose file expects an existing PostgreSQL server and the credential key file used on the host. Set FISHIE_UID and FISHIE_GID to the account that owns the project files, apply migrations, then start it:

sudo docker compose -f compose.production.yaml run --rm --no-deps fishie python manage.py migrate
sudo docker compose -f compose.production.yaml up -d --build fishie

The bot and API share one process. The API listens on port 8001 by default and /health/ready reports whether Discord and PostgreSQL are ready.

Run without Docker

Create a virtual environment, install the locked requirements, apply the migrations, and launch from src:

python3.13 -m venv venv
venv/bin/python -m pip install -r requirements.txt
cd src
../venv/bin/python manage.py migrate
../venv/bin/python launcher.py

FFmpeg, Chromium dependencies for Playwright, PostgreSQL, config.toml, and the credential key must already be available when running this way.