{"id":13458803,"url":"https://github.com/allthingslinux/tux","last_synced_at":"2026-02-02T06:50:43.918Z","repository":{"id":214400173,"uuid":"724754781","full_name":"allthingslinux/tux","owner":"allthingslinux","description":null,"archived":false,"fork":false,"pushed_at":"2024-04-13T21:31:07.000Z","size":4144,"stargazers_count":13,"open_issues_count":13,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-04-13T21:54:52.501Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://discord.gg/linux","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/allthingslinux.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2023-11-28T18:19:43.000Z","updated_at":"2024-04-15T18:32:20.027Z","dependencies_parsed_at":"2024-01-16T23:12:34.049Z","dependency_job_id":"5bfc2631-7e66-4473-aa46-48c352868919","html_url":"https://github.com/allthingslinux/tux","commit_stats":null,"previous_names":["allthingslinux/tux"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allthingslinux%2Ftux","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allthingslinux%2Ftux/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allthingslinux%2Ftux/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allthingslinux%2Ftux/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/allthingslinux","download_url":"https://codeload.github.com/allthingslinux/tux/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221987348,"owners_count":16912302,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-31T09:00:57.562Z","updated_at":"2026-02-02T06:50:43.912Z","avatar_url":"https://github.com/allthingslinux.png","language":"Python","readme":"\n\u003c!-- markdownlint-disable MD041 --\u003e\n\n\u003cdiv align=\"center\"\u003e\n    \u003cp align=\"center\"\u003e\n        \u003ca href=\"https://github.com/allthingslinux/tux/releases\"\u003e\n            \u003cimg alt=\"GitHub Release\" src=\"https://img.shields.io/github/v/release/allthingslinux/tux?logo=github\u0026logoColor=white\u0026include_prereleases\"\u003e\u003c/a\u003e\n        \u003ca href=\"https://python.org\"\u003e\n            \u003cimg alt=\"Python\" src=\"https://img.shields.io/badge/python-3.13.2+-blue?logo=python\u0026logoColor=white\"\u003e\u003c/a\u003e\n        \u003ca href=\"https://docs.astral.sh/uv\"\u003e\n            \u003cimg alt=\"uv\" src=\"https://img.shields.io/badge/uv-0.9.0+-purple?logo=uv\u0026logoColor=white\"\u003e\u003c/a\u003e\n        \u003ca href=\"https://results.pre-commit.ci/latest/github/allthingslinux/tux/main\"\u003e\n            \u003cimg alt=\"pre-commit.ci status\" src=\"https://results.pre-commit.ci/badge/github/allthingslinux/tux/main.svg\"\u003e\u003c/a\u003e\n        \u003ca href=\"https://codecov.io/gh/allthingslinux/tux\"\u003e\n            \u003cimg alt=\"Codecov\" src=\"https://codecov.io/gh/allthingslinux/tux/graph/badge.svg?token=R0AUAS996W\"\u003e\u003c/a\u003e\n        \u003ca href=\"https://github.com/allthingslinux/tux/blob/main/LICENSE\"\u003e\n            \u003cimg alt=\"License\" src=\"https://img.shields.io/github/license/allthingslinux/tux?logo=gnu\u0026logoColor=white\"\u003e\u003c/a\u003e\n    \u003c/p\u003e\n\u003c/div\u003e\n\n\u003cimg align=\"center\" src=\"assets/readme-banner.png\" alt=\"Banner\"\u003e\n\n\u003cdiv align=\"center\"\u003e\n    \u003ch1\u003eTux\u003c/h1\u003e\n    \u003cp\u003e\u003cstrong\u003eThe all-in-one open source Discord bot\u003c/strong\u003e\u003c/p\u003e\n    \u003cp\u003e\n        \u003ca href=\"https://tux.atl.dev\"\u003e📚 Docs\u003c/a\u003e •\n        \u003ca href=\"https://tux.atl.dev/faq/\"\u003e❓ FAQ\u003c/a\u003e •\n        \u003ca href=\"https://discord.gg/gpmSjcjQxg\"\u003e💬 Discord\u003c/a\u003e •\n        \u003ca href=\"https://github.com/orgs/allthingslinux/projects/13\"\u003e🗺️ Roadmap\u003c/a\u003e\n    \u003c/p\u003e\n\u003c/div\u003e\n\n\u003e [!WARNING]\n\u003e **This codebase is under heavy development and subject to breaking changes.** APIs, configurations, and features may change without notice. Documentation is not guaranteed to be accurate or up to date. Use at your own risk in production environments.\n\n---\n\n## Quick Start\n\nChoose your path to get started with Tux:\n\n| Role          | Get Started                                                                                   |\n|---------------|----------------------------------------------------------------------------------------------|\n| 👤 Users      | [Get Started](https://tux.atl.dev/user/)                                 |\n| ⚙️ Admins     | [Get Started](https://tux.atl.dev/admin/)                                |\n| 🐳 Self-Hosters | [Get Started](https://tux.atl.dev/selfhost/)                        |\n| 💻 Developers | [Get Started](https://tux.atl.dev/developer/)                            |\n\n## About\n\nTux is a feature-rich Discord bot originally built for the [All Things Linux](https://allthingslinux.org) community. It provides moderation tools, leveling systems, snippets, utilities, and fun commands - all in one package.\n\n**Key Features:**\n\n- **Moderation** - Comprehensive moderation tools with case management\n- **Leveling** - XP and ranking system to reward active members\n- **Snippets** - Quick text responses and custom commands\n- **Utilities** - Server management and utility commands\n- **Fun** - Entertainment commands and interactive features\n- **Plugin System** - Extensible architecture for custom functionality\n- **Caching** - Optional Valkey (Redis-compatible) cache for guild config, jail status, and permissions; falls back to in-memory TTL when Valkey is not configured\n\n## Why Tux?\n\n- **Modern tech stack** - Type-safe, async-first, powered by Python 3.13+ and discord.py\n- **Production-ready** - Battle-tested in large communities with comprehensive error handling\n- **Developer-friendly** - Clean architecture, extensive docs, and active development\n- **Free and open source** - Free to use, modify, and contribute under GPL-3.0\n\n## Tech Stack\n\n| Component | Technology |\n|-----------|------------|\n| **Runtime** | Python 3.13+ with `discord.py` |\n| **Package Manager** | `uv` for fast dependency management |\n| **Database** | PostgreSQL with `SQLModel` (`SQLAlchemy` + `Pydantic`) |\n| **Type Safety** | `basedpyright` with strict type hints |\n| **Code Quality** | `ruff` for linting and formatting |\n| **Testing** | `pytest` with async support |\n| **CLI** | `typer` with custom command scripts |\n| **Logging** | `loguru` for structured logging |\n| **Monitoring** | `sentry-sdk` for error tracking |\n| **HTTP Client** | `httpx` for async requests |\n| **Configuration** | `pydantic-settings` with json/env support |\n| **Containers** | Docker \u0026 Docker Compose |\n| **Cache** | `valkey` with in-memory fallback |\n\n## Documentation\n\nVisit **[tux.atl.dev](https://tux.atl.dev)** for complete documentation including:\n\n- **[User Guide](https://tux.atl.dev/user/)** - Commands, features, and usage\n- **[Admin Guide](https://tux.atl.dev/admin/)** - Configuration and server setup\n- **[Self-Hosting](https://tux.atl.dev/selfhost/)** - Installation and deployment\n- **[Developer Guide](https://tux.atl.dev/developer/)** - Architecture and contributing\n- **[API Reference](https://tux.atl.dev/reference/)** - CLI tools and codebase reference\n- **[FAQ](https://tux.atl.dev/faq/)** - Common questions and answers\n\n## Support \u0026 Community\n\n- **[Discord Server](https://discord.gg/gpmSjcjQxg)** - Get help, report issues, and discuss features\n- **[GitHub Issues](https://github.com/allthingslinux/tux/issues)** - Bug reports and feature requests\n\n**Developer Resources:**\n\n| Getting Started | Development Workflow | Quality \u0026 Standards |\n|-------------------|------------------------|----------------------|\n| [Developer Setup](https://tux.atl.dev/developer/tutorials/development-setup/) | [Git Best Practices](https://tux.atl.dev/developer/best-practices/git/) | [Testing Guide](https://tux.atl.dev/developer/best-practices/testing/) |\n| [First Contribution](https://tux.atl.dev/developer/tutorials/first-contribution/) | [Branch Naming](https://tux.atl.dev/developer/best-practices/branch-naming/) | [Code Review](https://tux.atl.dev/developer/best-practices/code-review/) |\n| [Project Structure](https://tux.atl.dev/developer/tutorials/project-structure/) | [Creating Commands](https://tux.atl.dev/developer/tutorials/creating-first-command/) | [Error Handling](https://tux.atl.dev/developer/best-practices/error-handling/) |\n\n## Project Stats\n\n![Metrics](https://repobeats.axiom.co/api/embed/e2782b71a13b2d36f5fcca1c90cd3ab014388ebf.svg)\n\n## Contributors\n\n![Contributors](https://contrib.rocks/image?repo=allthingslinux/tux)\n\n## License\n\nTux is free and open source software licensed under the [GNU General Public License v3.0](LICENSE).\n\nCreated by [@kzndotsh](https://github.com/kzndotsh) • Maintained by the [All Things Linux](https://allthingslinux.org) community\n","funding_links":[],"categories":["Bots","Example Bots"],"sub_categories":["Miscellaneous"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fallthingslinux%2Ftux","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fallthingslinux%2Ftux","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fallthingslinux%2Ftux/lists"}