Pyvespa provides a Python API to Vespa, the open-sourced serving engine for storing, computing, and ranking big data at user serving time. It enables users to create, modify, deploy, and interact with running Vespa instances, facilitating faster prototyping and familiarization with Vespa features. The current version is 1.1.2. Releases are generally frequent, with minor versions released multiple times a week for the main Vespa engine and `pyvespa` releases following to maintain compatibility and add features.
pip install pyvespaVerified import paths — ran on the pinned version, not inferred.
This quickstart demonstrates how to define a simple Vespa application schema, deploy it to a local Docker instance using `VespaDocker`, feed documents, and execute a basic query. It covers the core workflow for local development with pyvespa.
Migrate advanced configuration logic to use the new `pyvespa.configuration` modules and the VT system. Refer to the 'Advanced Configuration' documentation.
Allocate at least 6GB of memory to Docker. Before deploying, run `docker ps` and `docker ps -a -q -f status=exited` to identify and remove any conflicting or exited `pyvespa` containers using `docker rm -f <container id>`.
Ensure your application package name is valid and consistent. If the issue persists, it might be an transient error on the Vespa Cloud side; retrying or checking Vespa status can help.
Increase the disk space allocated to Docker in its settings. You may need to stop and restart the Vespa container.
To retrieve more hits, configure `maxHits` in a query profile. For example, add `<field name="maxHits">500</field>` to `search/query-profiles/default.xml` within your application package.