Lyra, an official Discord bot made by VX538 https://lyra.is-a.bot/
  • Python 99.8%
  • Dockerfile 0.2%
Find a file
Mason Aldrich 19c09798b6 Release beta 0.0.2
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-11 13:27:30 -04:00
docs Create CNAME 2026-10-10 17:43:50 -04:00
lyra Release beta 0.0.2 2026-10-11 13:27:30 -04:00
tests Release beta 0.0.2 2026-10-11 13:27:30 -04:00
.env.example Release beta 0.0.2 2026-10-11 13:27:30 -04:00
.gitignore Add Lyra bot and GitHub Pages site 2026-10-10 17:02:02 -04:00
docker-compose.yml Change volume mapping for discord-bot service 2026-10-10 18:49:28 -04:00
Dockerfile Refactor Dockerfile comments and create data directory 2026-10-10 18:48:59 -04:00
LICENSE.md Update license to include enterprise usage 2026-10-10 18:43:38 -04:00
pytest.ini Add Lyra bot and GitHub Pages site 2026-10-10 17:02:02 -04:00
README.md Release beta 0.0.2 2026-10-11 13:27:30 -04:00
requirements.txt Add Lyra bot and GitHub Pages site 2026-10-10 17:02:02 -04:00

Lyra

Lyra is a friendly, slightly futuristic Discord bot built in Python with discord.py, SQLite, and aiosqlite.

Lyra is currently in BETA. If you have any bugs, please make an issue so we can fix them ASAP.

Features

  • Feature toggles stored per Discord guild
  • Shared embed styling with a blue palette
  • Modular cogs for moderation, logging, utilities, leveling, and mini-games
  • SQLite-backed persistence with a migration-ready structure
  • Slash command interface
  • Optional per-server GitHub activity feeds

Run locally

  1. Create a virtual environment and install dependencies:
    python -m venv .venv
    source .venv/bin/activate
    pip install -r requirements.txt
    
  2. Copy .env.example to .env and fill in the values.
  3. Launch the bot:
    python -m lyra.main
    

Slash commands are globally registered at startup and may take time to appear in every server. For immediate development updates, set LYRA_DEV_GUILD_ID in .env to a test server ID; commands will also be synced to that server on startup.

GitHub activity feeds

Set GITHUB_TOKEN to a GitHub personal access token and optionally set GITHUB_POLL_INTERVAL (seconds; minimum 60, default 300). Feed polling uses the token for both public and private repositories so requests use the dedicated account's rate limit and permissions. Private repositories must be accessible to that account. Enable the feature for a server with /lyra enable gitfeed, then configure feeds with /gitfeed add.

GitHub's user activity endpoint contains only limited recent public events, and repository events (including stars) are best-effort rather than a complete history. Lyra polls the API and does not provide real-time or exhaustive monitoring.

Database persistence in Docker or containers

Set LYRA_DB_PATH to a mounted volume so the SQLite database survives container restarts, for example:

LYRA_DB_PATH=/data/lyra.db

Then mount a Docker volume or bind mount to /data.

Branding

Lyra uses a restrained blue-forward design and a personality that feels warm, friendly, and slightly robotic.