# 使用 Homebrew 安装 humanbound

查看 humanbound 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:humanbound
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install humanbound
```

  证据: local Homebrew formula metadata

## 软件包事实

- **软件包键:** brew:humanbound
- **软件包管理器:** Homebrew
- **版本:** 2.8.0
- **来源摘要:** Adversarial security testing engine, SDK, and CLI for AI agents
- **主页:** <https://docs.humanbound.ai/>
- **最后更新:** 2026-07-31T00:17:01Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- hb (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 2.8.0
## 项目历史与用法

Humanbound is an open-source adversarial testing engine, Python SDK, and hb command-line interface for AI agents. It drives multi-turn attacks against live agent endpoints, evaluates failures, and can turn findings into runtime guardrail rules.

### 项目历史

The official Humanbound repository was created in February 2026 and is maintained by the verified Humanbound GitHub organization. The project combines an Apache-licensed local engine with an optional hosted platform, allowing initial testing without a login while preserving a path to managed posture tracking.

The official release notes describe a consolidation around the humanbound PyPI package: the earlier humanbound-cli package was yanked, and the CLI and public SDK now ship together. The same repository also integrates with the sibling humanbound-firewall package for a test-to-guardrail workflow.

### 采用历史

Humanbound is a young project, so its reliable adoption history is limited. Official materials show distribution through PyPI, Homebrew in the supplied package facts, and an official GitHub Action for security gates in continuous integration.

### 使用方式

Users describe an agent endpoint in a JSON configuration file and optionally define permitted and restricted behavior in a scope file. The hb test command runs attacks locally or through the platform; hb posture, hb logs, and hb report inspect the results.

Local attack generation and judging can use OpenAI, Anthropic, Gemini, Azure OpenAI, Grok, or Ollama. Provider settings resolve from CLI flags, environment variables, and then ~/.humanbound/config.yaml; platform login credentials are stored under ~/.humanbound/.

### 为什么软件包爱好者会关心

Humanbound is notable as an AI-security tool that packages an engine, SDK, and CLI under one Python distribution while keeping the firewall as a composable sibling package. Its optional extras let package users choose the provider engine, firewall runtime, or both.

### 时间线

- 2026: The official humanbound/humanbound repository was created.
- 2026: The project consolidated the CLI and SDK in the humanbound PyPI package and yanked the older humanbound-cli package.
- 2026: The official release feed reached the v2.7 series.

### Related projects

- humanbound-firewall is the sibling Apache-licensed runtime that deploys rules generated from Humanbound findings.
- humanbound/actions is the official GitHub Action for running Humanbound checks in CI.

### 来源

- <https://docs.humanbound.ai/>
- <https://docs.humanbound.ai/authentication/>
- <https://docs.humanbound.ai/local-engine/provider-config/>
- <https://github.com/humanbound/humanbound>
- <https://github.com/humanbound/humanbound/releases>
- source_facts.package-manager


## 安全说明

没有找到 humanbound 的匹配本地密钥处理 manifest。Nucleus 软件包元数据仍在此发布，以便未来覆盖拥有稳定的软件包 URL。



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.humanbound/config.yaml

## Credential files

- Unix: ~/.humanbound/

## Combined YAML source

View the package source record on GitHub. [combined/humanbound.yml](https://github.com/mxcl/pkgdb/blob/main/combined/humanbound.yml)


## 来源

- pkg.so package database
- curated configuration and credential file locations
- curated package history
- cross-ecosystem install command graph