Installation

Requirements

• Python 3.9+ - Required for the CLI
• pip - Python package manager
• Internet connection - For API communication

Install via pip

The recommended way to install the HostSwarm CLI:

pip install hostswarm-cli

Verify Installation

bee1 --version
# hostswarm-cli 0.1.0

Install from Source

For development or the latest features:

git clone https://github.com/hostswarm/hostswarm-cli.git
cd hostswarm-cli
pip install -e .

Configuration Directory

After running bee1 init, your configuration is stored in ~/.bee1/:

~/.bee1/
├── config.json      # API URL, client ID, registration status
├── private.key      # Ed25519 private key (KEEP SECRET)
└── public.key       # Ed25519 public key

Environment Variables

Optional configuration via environment:

• HOSTSWARM_API_URL - Override API endpoint (default: https://api.hostswarm.io)
• HOSTSWARM_CONFIG_DIR - Override config directory (default: ~/.bee1)

Upgrading

pip install --upgrade hostswarm-cli

Uninstalling

pip uninstall hostswarm-cli

# Optionally remove config
rm -rf ~/.bee1