Repository navigation
Releases
KyberDex v0.3.0 — One-command bot setup
Set up the whole bot with one command on Linux, macOS or WSL:
curl -fsSL https://raw.githubusercontent.com/gavinjudd/kyberdex/main/install.sh | shThe installer prepares Python and dependencies, then walks through hidden bot-token entry, server verification, channel selection, protected saved configuration, automatic artwork installation and launch checks. Accept the final prompt to start the bot in the foreground.
- Creates a dedicated installation at
~/kyberdex;KYBERDEX_INSTALL_DIRsupports another absolute path. No sudo or shell-profile changes. - Guides Discord bot creation and browser invite authorization when needed. Requests the required channel permissions, without Administrator or privileged Message Content/Members intents.
- Saves token files outside the checkout with private permissions. Tokens never appear in command arguments or logs.
- Reuses completed downloads, dependencies and saved settings; preserves existing pauses, schedules and game state.
- Refuses conflicting environment settings, unsafe server changes and simultaneous workers.
Restart later with:
cd ~/kyberdex && ./start.shExisting updated Git clones can run uv run venator-vault setup. Add --no-start to configure and verify without starting.
Discord application creation and server installation approval still happen in your browser. Keep the terminal open for foreground operation; Linux service instructions remain available for unattended hosting.
Validation: 894 tests and 1,092 subtests passed locally. The published installer was verified through its hidden token prompt. Coverage includes offline installer/terminal integration, mocked Discord discovery, permission evaluation, hidden input, credential handling, interrupted installs, repeated setup and the existing gameplay regression suite. No live Discord token or player state was used in tests.
KyberDex v0.2.0 — One-command artwork setup
KyberDex now prepares the entire artwork collection with one command. Hosts no longer need to find and configure hundreds of images individually.
git clone https://github.com/gavinjudd/kyberdex.git
cd kyberdex
uv sync --locked
uv run venator-vault setup-art
uv run venator-vault check --require-artThe installer covers all 851 card definitions through 847 artwork files. It downloads recorded public sources, applies reviewed framing recipes, verifies source and RGB pixel hashes, and creates the local runtime manifest. Verified outputs and downloads are reused after interruptions. Existing bot workers must be stopped before installing or repairing artwork.
The full collection was downloaded and installed successfully, the repeat run reused all 847 outputs, and launch readiness reported zero missing art. Regression tests and offline failure/recovery tests passed.
Subject artwork remains outside the Git repository. Source retrieval does not grant copyright permissions; the MIT license covers the software. Your own Discord application, server configuration and token are still required.
KyberDex v0.1.0 — public source release
KyberDex is now open source: a self-hosted Star Wars Discord card collection game built with Python, discord.py and SQLite.
- 851 catalog definitions, rarity-based captures, collections, trades, crafting, Ground/Fleet battles and cooperative raids.
- Persistent activity-aware scheduling, transactional ownership, restart recovery and integrity-checked backups.
- Searchable public catalog, six-tier card renderer, contributor guides and portable single-server setup.
- MIT-licensed original software, with separate font and third-party content notices.
Start with the README or project website.
This is a source release. Third-party subject artwork, private deployment records, player data and credentials are excluded. A fresh clone supports offline tests and catalog browsing; live Discord gameplay requires your own bot configuration and reviewed artwork pack.
Validation: 816 tests and 1,092 subtests passed locally, Ruff passed, and the tracked-file publication check passed. The original Venator Command deployment was not changed by this release.