thinkpad/larry
Archived
1
0
Fork
You've already forked larry
0
free & open source discord bot for single-use communities, includes modules for (almost) everything you need https://linuxlarp.dev/community
This repository has been archived on 2026年06月01日. You can view files and clone it, but you cannot make any changes to its state, such as pushing and creating new issues, pull requests or comments.
  • Python 95.6%
  • Dockerfile 4.4%
Find a file
2026年05月09日 21:53:39 -07:00
src fix typo cuz im lazy asl 2026年05月09日 21:53:39 -07:00
.env.template breaking: mariadb dockerfile complaining 2026年05月06日 08:24:17 -07:00
.gitignore breaking: mariadb dockerfile complaining 2026年05月06日 08:24:17 -07:00
.python-version work on more documentation for contributors, switch to src/ for all code 2026年04月18日 17:01:14 -07:00
config.json Add basic logging, utils, and seperate models to avoid clutter, also add models for appconfig 2026年04月18日 19:21:11 -07:00
docker-compose.yml fix typo cuz im lazy asl 2026年05月09日 21:53:39 -07:00
Dockerfile breaking: mariadb dockerfile complaining 2026年05月06日 08:24:17 -07:00
LICENSE Initial commit 2026年04月19日 01:50:18 +02:00
pyproject.toml feat: add mariadb, and finish basic dockerfile and compose, update .env and pyproject.toml 2026年05月06日 08:06:34 -07:00
README.md breaking: mariadb dockerfile complaining 2026年05月06日 08:24:17 -07:00
uv.lock feat: add mariadb, and finish basic dockerfile and compose, update .env and pyproject.toml 2026年05月06日 08:06:34 -07:00

larry

Self-hosted discord bot for the larp cave Discord server. Including modules for moderation, mod mail, fun commands, utility commands, verification and more

setup

fork this repo on codeberg, or however you want

we use uv to package this project, install and learn the basics here

once installed

uv lock
uv sync

todo

modules:

  • basic loading and runtime (main.py)
  • moderation
  • mod mail / tickets
  • fun commands
  • utility commands
  • temporary voice
  • rss monitoring (later, optional)
  • verifiaction / captcha

backend/utils:

  • logging
  • database I/O
  • checks (roles, permissions, users)
  • crud operations (create, read, update)
  • config parser and loader

some modules and backends might have a higher priority, work on those first if you wish to contribute

contributing

fork the repo use git clone commit your local changes to your repo make a PR to provide contriutions

we recommend makin your own discord server and bot, .env template will be provided soon and other stuff like permissions required

ai usage

AI assistance or usage is not allowed to be used on this project, use it for a reference at best, do not ctrl+c && ctrl+v whatever cluade tells you

dev overview

  • src/main.py - entrypoint
  • src/utils/ - all other non-essential utils, eg time conversions, other stuff
  • src/core/ - core stuff, database I/O, config impl
  • src/cogs/ - all commands and features of the bot