Installation

Q: How do I install Humanbound with local engine support?

Run `pip install "humanbound[engine]"` to include the local testing engine with OpenAI, Anthropic, and Google SDK support. The base `pip install humanbound` installs the CLI without the local engine extras.

Q: What optional extras can I install with Humanbound?

Three extras are available — `engine` adds the local testing engine, `firewall` adds firewall training with scikit-learn and torch, and `mcp` adds an MCP server for AI coding assistants.

Q: How do I verify my Humanbound installation?

Run `hb --version` to confirm the CLI is installed and `hb --help` to see available commands.

Install Humanbound with pip install humanbound, optionally adding extras for the local testing engine, firewall training, or MCP server. The sections below walk through the install command, the available extras, system requirements, and running your first test, with pointers to provider configuration and the Quick Start guide.

Install

pip install humanbound

For local engine support (run tests without login):

pip install "humanbound[engine]"

Verify

hb --version
hb --help

Requirements

Python 3.10 or higher
An LLM provider API key (OpenAI, Anthropic, Azure, etc.) OR ollama for full local isolation
An AI agent endpoint to test against

Optional Dependencies

Extra	Install	What it adds
`engine`	`pip install "humanbound[engine]"`	Local testing engine (OpenAI, Anthropic, Google SDKs)
`firewall`	`pip install "humanbound[firewall]"`	Firewall training (humanbound-firewall, scikit-learn, torch)
`mcp`	`pip install "humanbound[mcp]"`	MCP server for AI coding assistants

Configure Provider

Before running local tests, configure your LLM provider:

# Environment variables (recommended for CI/CD)
export HB_PROVIDER=openai
export HB_API_KEY=sk-...

# Or config file (recommended for interactive use)
hb config set provider openai
hb config set api-key sk-...

# Or ollama (no API key needed)
export HB_PROVIDER=ollama
export HB_MODEL=llama3.1:8b

See Provider Configuration for all supported providers.

First Test

hb test --endpoint ./bot-config.json --repo . --wait

See Quick Start for the full walkthrough.

Frequently asked questions

What are the system requirements for Humanbound?

Humanbound requires Python 3.10 or higher, an LLM provider API key (OpenAI, Anthropic, Azure, etc.) or ollama for full local isolation, and an AI agent endpoint to test against.

How do I install Humanbound with local engine support?

Run pip install "humanbound[engine]" to include the local testing engine with OpenAI, Anthropic, and Google SDK support. The base pip install humanbound installs the CLI without the local engine extras.

What optional extras can I install with Humanbound?

Three extras are available — engine adds the local testing engine, firewall adds firewall training with scikit-learn and torch, and mcp adds an MCP server for AI coding assistants.

Do I need an API key to run tests?

You need an LLM provider API key (OpenAI, Anthropic, Azure, etc.) for cloud-based testing, but you can use ollama with no API key at all for full local isolation.

How do I verify my Humanbound installation?

Run hb --version to confirm the CLI is installed and hb --help to see available commands.