---
id: pyvespa
version: "1.2.4"
license: Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# pyvespa — Python API for vespa.ai

License: permissive · Maintenance: active · Downloads: 17.4M/mo

## What it is and what it does

pyvespa is a Python wrapper around Vespa, an open-source serving engine designed for large-scale search, ranking, and data computation at query time. It abstracts Vespa's deployment and interaction model into a Python API, allowing developers to programmatically create application schemas, deploy configurations, and execute queries without direct command-line or REST interaction.

The library is built for prototyping and experimentation with Vespa features. It depends on standard HTTP clients (requests, httpx), templating (jinja2), and utility libraries (tenacity for retries, cryptography for secure communication) to manage the full lifecycle of a Vespa application—from schema definition through deployment to live query execution. The package also wraps the Vespa CLI for command-line operations.

Use it for:

- Prototype a search application with custom ranking models before deploying to production
- Automate Vespa cluster deployment and configuration management in data science workflows
- Build integration tests for search and ranking logic by programmatically creating and querying instances
- Experiment with different schema designs and ranking functions iteratively in notebooks
- Deploy Vespa applications as part of a larger Python data pipeline or ML workflow

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

pyvespa provides a Python API to create, deploy, and interact with Vespa instances, enabling programmatic control over a scalable serving engine for storing, computing, and ranking data at query time.

Yes, if you are working with Vespa or evaluating it for search and ranking use cases. The package is actively maintained, has low install friction, carries a permissive Apache 2.0 license, and no known vulnerabilities. It is well-positioned for prototyping and integration into Python-based data science and search workflows. Install it if Vespa is already part of your architecture or you are exploring it.

## Install

pip install pyvespa
uv add pyvespa
poetry add pyvespa

## Installing pyvespa

Before you install: Low install friction with a pure-Python wheel distribution. The package is actively maintained with a recent release 42 days ago and an active repository. It carries 13 runtime dependencies including standard ecosystem libraries.

License in practice: Licensed under Apache 2.0, a permissive open-source license that allows commercial use, modification, and distribution with minimal restrictions. You may use and modify the code freely provided you include the license and attribution notices.

Quickstart:

pip install pyvespa

import pyvespa
from pyvespa import Vespa

app = Vespa(url="http://localhost")
results = app.query(yql="select * from doc where true")

Requires a running Vespa instance accessible at the specified URL; Python 3.10 or later (requires_python >=3.10,<3.14).

Verify before relying:

- Whether docker dependency is a runtime requirement or only for local development
- Specific Vespa server version compatibility constraints
- Exact URL format and port requirements for connecting to Vespa instances

## Package facts

- License: Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 17.4M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

vespa python api, search engine deployment, ranking and retrieval, data serving platform, vespa cli wrapper, prototype search applications, large-scale search indexing, search-engine, ranking-retrieval, distributed-computing

[View on SkillFed](https://skillfed.io/packages/pyvespa) · [View on PyPI](https://pypi.org/project/pyvespa/)