# 使用 Homebrew, Nix 安装 vespa-cli

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

## 安装

```sh
sudo av install brew:vespa-cli
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install vespa-cli
```

  证据: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#vespa-cli
```

  证据: nixpkgs package indexes: pkgs/by-name/ve/vespa-cli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## 软件包事实

- **软件包键:** brew:vespa-cli
- **软件包管理器:** Homebrew
- **版本:** 8.730.36
- **来源摘要:** Command-line tool for Vespa.ai
- **主页:** <https://vespa.ai>
- **仓库:** <https://github.com/vespa-engine/vespa>
- **最后更新:** 2026-07-28T07:03:36Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- vespa (别名)
- vespa-wrapper (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

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

Vespa CLI is the official command-line client for Vespa, the open-source AI search and big-data serving platform. The CLI packages common Vespa developer and operator actions into a single Go-built binary: deploying applications, feeding and querying documents, sending authenticated requests, and automating Vespa Cloud operations.

### 项目历史

Vespa itself was open-sourced by Yahoo/Oath on September 27, 2017 as a big-data processing and serving engine for real-time search, recommendation, and personalization workloads. The open-source announcement positioned Vespa as the serving complement to batch and stream processing stacks such as Hadoop and Storm.

Vespa CLI was introduced on September 23, 2021. The announcement says Vespa users had historically deployed and interacted with applications through APIs or a Maven plugin, both of which had friction: API use meant copying dense terminal commands and Maven assumed a Java toolchain. The CLI was built as an official zero-dependency command-line tool for both self-hosted Vespa and Vespa Cloud.

In October 2023, Vespa.ai spun out of Yahoo as a separate company. Vespa's own announcement tied the spinout to the platform's evolution from Yahoo search, recommendation, and ad-serving infrastructure into a serving-time AI platform used for large datasets, vector search, and production relevance systems.

### 采用历史

The CLI's adoption follows Vespa's adoption path: it became the normal local and cloud workflow surface for developers working with Vespa applications. Official documentation presents it as the command-line client for Linux, macOS, and Windows, and the command tree covers the everyday lifecycle from clone and deploy through feed, query, inspect, status, logs, tests, and production deployment.

Vespa's 2023 spinout announcement gives broader adoption context: Yahoo remained a major customer, the platform was serving personalized content and search use cases, and Vespa Cloud was already supporting production workloads. In that setting, the CLI is not just a convenience wrapper; it is the developer-facing entry point for a large hosted and self-managed search platform.

### 使用方式

Vespa CLI is used to clone sample applications, deploy application packages locally or remotely, deploy to Vespa Cloud, feed documents, query documents, and send authenticated custom requests. The docs also show it managing mTLS-related local state under `.vespa` and switching between local and cloud targets.

In package terms, `vespa` is the handle that turns Vespa from a server platform into an iterative developer workflow. A user can create or fetch an application package, deploy it, stream documents into it, run queries, inspect status, follow logs, and automate deployment operations without manually stitching together HTTP requests and authentication material.

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

Vespa CLI is significant because it condenses a complex distributed search platform into a reproducible command-line workflow. For packagers and operators, it is the small binary that makes Vespa approachable on a laptop, in CI, and in cloud automation, while still mapping directly to production Vespa concepts such as tenants, applications, instances, zones, deployments, documents, and queries.

### 时间线

- 2016-06-03: Vespa GitHub repository created.
- 2017-09-27: Yahoo/Oath announced Vespa as open source on GitHub.
- 2021-09-23: Vespa CLI introduced as the official zero-dependency command-line tool.
- 2023-10-03: Vespa.ai announced it was spinning out of Yahoo as a separate company.

### Related projects

- Vespa: the search, recommendation, and AI serving platform controlled by the CLI.
- Vespa Cloud: the hosted service targeted by the CLI for cloud deployment and operations.
- Maven plugin and direct Vespa APIs: the older interaction methods the CLI was designed to simplify.

### 来源

- <https://api.github.com/repos/vespa-engine/vespa>
- <https://blog.vespa.ai/introducing-vespa-cli/>
- <https://blog.vespa.ai/open-sourcing-vespa-yahoos-big-data-processing/>
- <https://blog.vespa.ai/vespa-is-becoming-its-own-company/>
- <https://docs.vespa.ai/en/clients/vespa-cli.html>
- <https://github.com/vespa-engine/vespa>


## 安全说明

没有找到 vespa-cli 的匹配本地密钥处理 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: ~/.vespa, ./.vespa

## Credential files

- Unix: ~/.vespa/<tenant>.<application>.<instance>/data-plane-private-key.pem, ./.vespa/<tenant>.<application>.<instance>/data-plane-private-key.pem
## 其他软件包管理器记录

- Nix - vespa-cli: normalized package name match | nixpkgs package indexes: pkgs/by-name/ve/vespa-cli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Combined YAML source

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


## 来源

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