# Install vespa-cli with Homebrew, Nix Command-line tool for Vespa.ai. Version 8.719.5 via Homebrew; verified 2026-07-07. ## Install ```sh sudo av install brew:vespa-cli ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install vespa-cli ``` Evidence: local Homebrew formula metadata ### Linux - Nix (92%): ```sh nix profile install nixpkgs#vespa-cli ``` Evidence: nixpkgs package indexes: pkgs/by-name/ve/vespa-cli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:vespa-cli - **Package manager:** Homebrew - **Package manager page:** - **Version:** 8.719.5 - **Source summary:** Command-line tool for Vespa.ai - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 - **Source archive:** - **Last updated:** 2026-07-07T04:09:50Z - **Generated:** 2026-07-08T18:08:21+00:00 ## Executables - vespa (cli) - vespa-wrapper (cli) - vespa (alias) - vespa-wrapper (alias) ## Build dependencies - go ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 8.719.5 - Package-manager updated: 2026-07-07 - Local data: ok - Upstream repository: https://github.com/vespa-engine/vespa - Upstream latest detected: v8.719.5 (current) ## Project history and usage 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. ### Project history 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. ### Adoption history 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. ### How it is used 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. ### Why package nerds care 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. ### Timeline - 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. ### Sources - - - - - - ## Security Notes No matching local secret-handling manifest was found for vespa-cli. Nucleus package metadata is still published here so future coverage has a stable package 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/../data-plane-private-key.pem, ./.vespa/../data-plane-private-key.pem ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** vespa-cli - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Other Package-Manager Records - 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 ## Related links - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [Database and data packages](https://www.automicvault.com/pkg/database-data-tools/) - Matched database, SQL, migration, or data-store metadata. - [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew. - [carrot2](https://www.automicvault.com/pkg/brew/carrot2/) - Shares av.db curated category or tags: cli, data, search. - [meilisearch](https://www.automicvault.com/pkg/brew/meilisearch/) - Shares av.db curated category or tags: cli, data, search. - [opensearch-dashboards](https://www.automicvault.com/pkg/brew/opensearch-dashboards/) - Shares av.db curated category or tags: cli, data, search. - [pgroonga](https://www.automicvault.com/pkg/brew/pgroonga/) - Shares av.db curated category or tags: cli, data, search. - [solr](https://www.automicvault.com/pkg/brew/solr/) - Shares av.db curated category or tags: cli, data, search. - [sonic](https://www.automicvault.com/pkg/brew/sonic/) - Shares av.db curated category or tags: cli, data, search. - [cubejs-cli](https://www.automicvault.com/pkg/brew/cubejs-cli/) - Shares av.db curated category or tags: cli, data. - [groonga](https://www.automicvault.com/pkg/brew/groonga/) - Shares av.db curated category or tags: cli, data, search. - [iceberg-cli](https://www.automicvault.com/pkg/brew/iceberg-cli/) - Local package facts share a topical domain. Shared terms: cli, command-line, data, line. ## Combined YAML source View the package source record on GitHub. [combined/vespa-cli.yml](https://github.com/automic-vault/db/blob/main/combined/vespa-cli.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph