# 使用 Homebrew 安装 aiven-client

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

## 安装

```sh
sudo av install brew:aiven-client
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install aiven-client
```

  证据: local Homebrew formula metadata

## 软件包事实

- **软件包键:** brew:aiven-client
- **软件包管理器:** Homebrew
- **版本:** 4.16.0
- **来源摘要:** Official command-line client for Aiven
- **主页:** <https://aiven.io/docs/tools/cli>
- **仓库:** <https://github.com/aiven/aiven-client>
- **最后更新:** 2026-07-08T15:12:54Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- avn (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

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

Aiven CLI is the official command-line client for Aiven's managed cloud services platform. It is distributed as the `aiven-client` Python package and installs the `avn` executable, giving users a scriptable interface to Aiven projects, services, users, events, clouds, and access tokens.

### 项目历史

The public GitHub repository was created in December 2015, fitting Aiven's early period of exposing its managed-service platform through APIs and automation tooling. The README describes `aiven-client (avn)` as the official command-line client for Aiven and positions it beside the backend service rather than as a third-party wrapper.

The project remained a Python CLI with a small Unix-friendly surface: install from PyPI or Homebrew, authenticate once, then drive Aiven resources through commands that can emit raw REST API JSON for use with tools such as `jq`.

### 采用历史

Adoption is mainly tied to Aiven customers and operators rather than to a general-purpose developer audience. Official docs document pip and Homebrew installation, and the Homebrew formula appears in the input package-manager facts as `brew:aiven-client`.

The tool's durable package-manager value is that it gives Homebrew users a first-party `avn` binary without needing to remember Python packaging details, while still staying aligned with the PyPI package and the upstream Aiven API.

### 使用方式

Typical use starts with `avn user login`, either with a username/password flow or an access token generated in the Aiven Console. The client can also read an auth token from `~/.config/aiven/aiven-credentials.json` and a default project from `~/.config/aiven/aiven-client.json`.

The CLI is used for project selection, cloud-region listing, service management, event inspection, access-token management, and automation scripts. Its `--json` output is explicitly documented for piping REST API responses into other command-line tools.

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

For package-manager users, `aiven-client` is a classic vendor CLI formula: the package is not interesting because it is a new language runtime, but because it pins a first-party cloud API surface into reproducible local tooling.

The split between PyPI, uvx, and Homebrew also makes it a useful example of a Python command-line package that needs to feel native in several installer cultures while preserving one executable name, `avn`.

### 时间线

- 2015: Public GitHub repository created for `aiven/aiven-client`.
- Later: Official docs document PyPI, uvx, and Homebrew installation paths.
- 2026: Official docs still present the Aiven CLI as the scriptable command-line interface for the Aiven platform.

### Related projects

- Aiven API: the REST API surface that the CLI exposes for shell usage.
- Aiven MCP: a newer official Aiven tool documented alongside the CLI for natural-language management of Aiven services.

### 来源

- <https://aiven.io/docs/tools/cli>
- <https://api.github.com/repos/aiven/aiven-client>
- <https://github.com/aiven/aiven-client>
- input source_facts.package-manager.brew


## 安全说明

没有找到 aiven-client 的匹配本地密钥处理 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: ~/.config/aiven/aiven-client.json

## Credential files

- Unix: ~/.config/aiven/aiven-credentials.json

## Combined YAML source

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


## 来源

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph