Quick Start

Getting Started with Blackhole

From zero to a fully encrypted WireGuard mesh in under five minutes. Install the CLI, connect your first device, and invite a teammate — all with a single command.

Prerequisites

macOS 12+, Linux kernel 5.6+, or Windows 10/11
Assisted-beta access or a validated onboarding path
Admin / sudo access on each device

Install & Connect

Install the Blackhole CLI

The installer path, dependencies, and signing checks are confirmed during assisted onboarding.

macOS / Linuxcopy

# Confirm installer URL during assisted onboarding

Windows (PowerShell as Admin)copy

# Confirm Windows installer path during assisted onboarding

Package names, checksums, and supported operating systems remain in the claim ledger until release packaging is published.

Quick start — sign in and join mesh

The quickstart wizard handles sign-in, WireGuard setup, and mesh join in one command. It opens a browser window for OAuth — no password is stored locally.

bashcopy

blackhole quickstart

After setup completes, your device gets a stable 100.x.x.x address within your mesh. Verify with:

bashcopy

blackhole mesh status
# Blackhole running
# Mesh IP: 100.64.0.1
# Peers: 0 connected

Create a company

Create a virtual AI company with agents, roles, and budgets. Each company gets its own isolated mesh subnet and NATS namespace.

bashcopy

blackhole company create
# Interactive wizard:
#  Company type: Virtual
#  Industry: SaaS
#  Template: 2-Person Startup
#  Creating mesh subnet... done
#  Company "My AI Startup" created (id: abc123)

List your companies or view a dashboard:

bashcopy

blackhole company list
blackhole company dashboard abc123

Browse the marketplace

Browse available virtual companies and agent skills on the built-in marketplace. Buy a pre-built company template or sell your own.

bashcopy

blackhole marketplace browse
# ID          Title              Price    Type
# lst_001     SaaS Factory       $49.99   virtual_company
# lst_002     Content Studio     $29.99   virtual_company

Chat via Gatekeeper

Route AI requests through validated provider candidates via the mesh. Routing behavior, failover, and API compatibility are confirmed during assisted onboarding.

bashcopy

blackhole gatekeeper chat "Hello, what can you do?"
# Provider: anthropic (claude-3-5-sonnet)
# Response: I can help you with...
# Tokens: 15 (prompt: 10, completion: 5)

Next steps

Read the Architecture

WireGuard mesh, NAT traversal, relay system

Explore the API

Automate device management via REST

Gatekeeper AI Gateway

Provider candidates and mesh routing validated during onboarding

View Pricing

Personal free / Starter $3 / Pro $9