Install with Nix

Install with Nix

The locked flake publishes BlokeBot for x86_64-linux, aarch64-linux, and aarch64-darwin.

Run without installing

nix run github:alsi-lawr/BlokeBot#blokebot -- serve

Install into a profile

nix profile install github:alsi-lawr/BlokeBot#blokebot
blokebot serve

Build locally

nix build github:alsi-lawr/BlokeBot#blokebot
./result/bin/blokebot serve

The flake exposes both default and blokebot package/app names. The wrapper finds the immutable application content automatically but does not choose Twitch credentials or writable state paths.

To run the explicit serve command from the local flake:

nix run .#blokebot -- serve

--host and --port create an HTTP listener. To configure a direct HTTPS listener with a certificate, use serve --config; see Configuration sources.

For a direct production-style run, set at least:

install -d -m 700 "$HOME/.local/state/blokebot"
export ASPNETCORE_ENVIRONMENT=Production
export BlokeBot__DatabasePath="$HOME/.local/state/blokebot/blokebot.db"
export TwitchBot__Identity__TokenCachePath="$HOME/.local/state/blokebot/twitch.tokens.json"
blokebot serve --host 127.0.0.1 --port 8080

Custom-bot Data Protection keys are managed automatically in private persistent application state. Use the NixOS service for a managed deployment. Use nix develop for the repository's .NET, Node, and nixfmt development shell.