wlinator/tux
1
Fork 0
mirror of https://github.com/allthingslinux/tux.git synced 2024-10-03 00:53:12 +00:00
Code Issues Releases Wiki Activity
Tux is an all in one bot for the All Things Linux discord server.
919 commits 28 branches 0 tags 14 MiB
Python 99.7%
Dockerfile 0.2%
Just 0.1%
Find a file
kzndotsh 9f00790354 refactor(event.py): use bot.get_channel instead of guild.get_channel for better reliability 
feat(event.py): add logging for channel details for better debugging
fix(event.py): change channel type check to use isinstance for more accurate type checking
style(event.py): remove unnecessary message existence check for cleaner code
2024-08-03 23:08:33 +00:00
.archive refactor(notes.py, dev.py, eval.py, git.py, mail.py): replace ctx.reply with ctx.send for better compatibility 2024-07-31 22:56:03 +00:00
.github Delete .github/dependabot.yml 2024-06-21 12:15:50 -04:00
assets feat(pre-commit-config.yaml): update ruff-pre-commit version to v0.5.5 for latest features and bug fixes 2024-07-25 19:24:41 +00:00
config perm system part 1 2024-07-29 11:45:22 -05:00
docs Update docs/CONTRIBUTING.md 2024-08-02 06:51:18 -03:00
prisma feat(schema.prisma): switch from development to production database by changing environment variables to improve data security and performance 2024-08-03 03:51:02 +00:00
tux refactor(event.py): use bot.get_channel instead of guild.get_channel for better reliability 2024-08-03 23:08:33 +00:00
.editorconfig feat: add .editorconfig for consistent coding style across different editors 2024-04-11 20:22:47 +00:00
.env.example chore(.env.example): restructure and clean up environment variables for better organization and clarity 2024-07-13 19:21:16 +00:00
.gitignore perm system part 1 2024-07-29 11:45:22 -05:00
.mise.toml feat: add .editorconfig for consistent coding style across different editors 2024-04-11 20:22:47 +00:00
.pre-commit-config.yaml feat(pre-commit-config.yaml): update ruff-pre-commit version to v0.5.5 for latest features and bug fixes 2024-07-25 19:24:41 +00:00
docker-compose.yml feat(Dockerfile, docker-compose.yml): add 'poetry run prisma py fetch' to CMD and command for fetching latest Prisma schema before generating Prisma client and running the app 2024-08-01 23:43:48 +00:00
Dockerfile feat(Dockerfile, docker-compose.yml): add 'poetry run prisma py fetch' to CMD and command for fetching latest Prisma schema before generating Prisma client and running the app 2024-08-01 23:43:48 +00:00
justfile feat(docs): add MkDocs documentation with initial pages 2024-07-31 01:38:07 +00:00
LICENSE.md Update LICENSE.md 2024-06-21 23:54:58 -04:00
mkdocs.yml feat(docs): add MkDocs documentation with initial pages 2024-07-31 01:38:07 +00:00
poetry.lock feat(schema.prisma): uncomment development database URLs and comment production URLs for development testing 2024-08-03 03:50:36 +00:00
poetry.toml feat(poetry.toml): add poetry.toml file to create virtual environments within the project directory 2024-07-02 19:19:07 +00:00
pyproject.toml feat(schema.prisma): uncomment development database URLs and comment production URLs for development testing 2024-08-03 03:50:36 +00:00
README.md docs(README.md): enhance readability of development notes using blockquote 2024-08-01 23:31:47 +00:00
renovate.json Add renovate.json 2024-04-11 20:02:04 +00:00

README.md

Tux

A Discord bot for the All Things Linux Discord server

NOTE: This bot (without plenty of tweaking) is not ready for multi-server use, we recommend against using it until it is more complete

About

Tux is a Discord bot for the All Things Linux Discord server. It is designed to provide a variety of features to the server, including moderation, support, utility, and various fun commands. The bot is written in Python using the discord.py library.

Tech Stack

  • Poetry for dependency management
  • Docker and Docker Compose for development and deployment
  • Strict typing with Pyright and type hints
  • Type safe ORM using Prisma
  • PostgreSQL database with Supabase
  • Linting and formatting via Ruff and Pre-commit
  • Justfile for easy CLI commands
  • Beautiful logging with Loguru
  • Exception handling with Sentry

Bot Features

  • Asynchronous codebase
  • Hybrid command system with both slash commands and traditional commands
  • Cog loading system with hot reloading
  • Branded embeds and messages
  • Robust error handling
  • Activity rotation
  • Custom help command
  • Configuration system
  • Dynamic role-based (access level) permission system

Installation

Prerequisites

  • Python 3.12
  • Poetry
  • Optional: Docker if you want to run the bot in a container.
  • Optional: Docker Compose if you want to define the container environment in a docker-compose.yml file.
  • Optional: Just if you want to use the Justfile for easy CLI commands.

Steps

  1. Clone the repository

    git clone https://github.com/allthingslinux/tux && cd tux

  2. Install the dependencies

    poetry install

  3. Activate the virtual environment

    poetry shell

  4. Install the pre-commit hooks

    pre-commit install

  5. Generate the prisma client

    prisma generate

  6. Copy the .env.example file to .env and fill in the required values

    cp .env.example .env

  7. Copy the config/settings.json.example file to config/settings.json and fill in the required values

    cp config/settings.json.example config/settings.json

  8. Run the bot

    poetry run python tux/main.py

  9. Run the sync command in the server to sync the slash command tree.

    {prefix}dev sync <server id>

Development Notes

Note

Make sure to add your discord ID to the sys admin list if you are testing locally.

Note

Make sure to set the prisma schema database ENV variable to the DEV database URL.

License

This project is licensed under the terms of the The GNU General Public License v3.0. See the LICENSE file for details.

Metrics

Alt