What problem does it solve? Setting up an Ava cluster from a fresh machine involves many moving parts: provisioning Postgres and Redis, choosing gateway versus agent-runner capabilities, handling secrets safely, and dealing with WSL or restricted-network environments. This Skill provides the operational walkthrough to bring a cluster up correctly the first time. ## Core Features & Use Cases - Single-box and split deployment: Install one machine carrying both gateway and agent-runner capabilities, or split them across machines with install.sh --role and ava enroll. - Secrets and bootstrap guidance: Explains AVA_CLUSTER_SECRET handling, the /api/bootstrap config flow, and safe secret entry without shell history exposure. - Environment-specific paths: Covers WSL bring-up notes, China mirror installs via --mirror cn, and macOS firewall considerations. - Use Case: You have a fresh Linux VPS and want a working Ava cluster. Follow the single-box path: clone the repo, run install.sh --role gateway,agent-runner, add your model key to ~/.ava/.env, then run ava start --machine-name <name> and verify by spawning your first agent. ## Quick Start Ask the assistant to walk you through installing a single-box Ava cluster on this machine, starting with the git clone and install.sh command and ending with a verified first agent spawn.
