Repository navigation
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.