Getting Started

Quick start: Create and run a minimal Vespa application

Other ways to get started:

• Quick start, application with Java components
• Quick start, using the Pyvespa Python API
• Docker Desktop: Install and run Vespa locally
• Docker Desktop: Install and run Vespa locally, with Java components

Until you add multiple nodes an application can be deployed both on cloud and locally with no modifications.

Moving from the minimal quick start to more advanced use cases

• Tutorial: Text Search. A text search tutorial and introduction to text ranking with Vespa using traditional information retrieval techniques like BM25.
• Tutorial: Improving Text Search with Machine Learning. This tutorial builds on the text search tutorial but introduces Learning to Rank to improve relevance.
• Tutorial: Text Search using Vectors. This tutorial introduces use of pre-trained embedding models to do text search. It uses Vespa's support for nearest neighbor search, there is also support for fast approximate nearest neighbor search in Vespa. See also how to achieve state-of-the-art text ranking results using pre-trained transformer language models with the MS Marco Ranking sample application.

Learn how to use Vespa Vector Search in the practical nearest neighbor search guide. It uses Vespa's support for nearest neighbor search, there is also support for fast approximate nearest neighbor search in Vespa. The guide covers combining vector search with filters and how to perform hybrid search, combining retrieval over inverted index structures with vector search.

Learn how to use Vespa for content recommendation/personalization in the News Search and Recommendation tutorial set.

Learn how to use Vespa for ML model serving in Stateless Model Evaluation. Vespa has support for running inference with models from many popular ML frameworks which can be used for ranking, query classification, question answering, multi-modal retrieval and more.

• Ranking with ONNX models. Export models from popular deep learning frameworks such as PyTorch to ONNX format for serving in Vespa. Vespa integrates with ONNX-Runtime for accelerated inference. Many ML framework support exporting model to ONNX, including sklearn.
• Ranking with LightGBM models
• Ranking with XGBoost models
• Ranking with TensorFlow models

The Models hot swap tutorial shows a solution for changing the vector embedding model atomically while serving. It also extends the application to support multiple recommendation models while minimizing data duplication. Lastly, it demonstrates how to efficiently garbage collect obsolete content in an application.

Using Vespa to answer questions. This sample application demonstrates several of the advanced capabilities of Vespa. Ranking with Transformer (e.g. BERT) models, dense retrieval using vectors, multiphased retrieval and ranking, and custom plugins to build an end-to-end application.

The e-commerce shopping sample application demonstrates Vespa grouping, true in-place partial updates, custom ranking and more.

Vespa can be deployed in multiple ways. These guides show how to deploy multi-node applications in various environments.

• Production deployments on Vespa Cloud
• Vespa high-availability multi-node template
• Vespa multinode testing and observability
• Using Kubernetes with Vespa
• AWS EC2 multinode
• AWS ECS multinode

See also monitoring Vespa.

Vespa applications can contain custom components to be run by Vespa, for example on receiving queries or documents. The applications must be able to run on a JVM. While all the built-in behavior of Vespa can be invoked by an YQL query, advanced applications often choose to use plugin components to build queries from frontend requests as doing this closer to the data is faster and simpler.

See the quick starts with Java above to get started. The Developer Guide has more details.