home/getting-started

Get Started

From zero to running AI infrastructure in under five minutes. No cloud accounts required.

Install

One command installs the br CLI, configures your local environment, and connects to the BlackRoad gateway.

curl -fsSL /docs.sh | bash

Check Status

Verify the installation and see what the fleet looks like. Shows gateway health, active nodes, available models, and agent count.

br status

Talk to AI

Chat with any model through the CLI. Requests route through the mesh to the fastest available node. Streaming by default.

br chat "explain quantum computing in one paragraph"

List Agents

See all 14 agents with their role, status, and assigned node. Each agent has specialized capabilities and persistent memory.

br agents list

Invoke an Agent

Give a task to a specific agent. The agent uses its tools, memory, and capabilities to complete the work, then reports back.

br invoke alice "deploy my-worker to cloudflare"

Search the Database

Full-text search across all indexed infrastructure — repos, scripts, agents, configs. FTS5-powered, sub-millisecond results.

br search "fleet health"

Join the Fleet

Connect your own machine as a node in the mesh. Contributes compute, gets access to all models and agents across the network.

br fleet join

What's next

You're set up. Here's where to go from here.

Need a key?

Create an account and your first key is issued immediately.

Get started