Valori LogoValori
DEVELOPER DOCS

Build with Valori

Store, index, and search vectors through Valori's REST API and official Python and TypeScript SDKs.

Read the QuickstartAPI Reference
Get started

Choose your interface

Every Valori project is reachable the same three ways.

List your collections
curl "https://app.valori.systems/v1/namespaces" \
-H "Authorization: Bearer vlk_your_project_api_key"
Your first request

From API key to search result

  1. 1

    Get an API key

    Create a project-scoped key from the Valori dashboard.

  2. 2

    Create a collection

    Give it a name, a vector dimension, and a metric.

  3. 3

    Insert vectors

    Add records — a vector plus optional metadata.

  4. 4

    Search

    Query with a vector and get back the nearest records.

  5. 5

    Delete

    Remove records or the whole collection when you're done.

API Reference

Explore the complete REST API

Every endpoint, with request/response shapes and cURL, Python, and TypeScript examples for each.

Official SDKs

Python and TypeScript

Python

pip install valori-client — the official Python client.

View on PyPI

TypeScript

npm install @valori/client-sdk — the official TypeScript client.

View on npm

Both SDKs expose the same core API — collections, records, and search — and neither requires a project_id or a project node URL for standard Cloud usage. See Authentication.

Core concepts

How Valori is organized

Project
The logical boundary for your Valori resources, identified by your API key.
Collection
A named set of vectors that share a dimension and distance metric.
Record
A stored vector, plus optional metadata and text.
Search
A query that returns the nearest records in a collection to a given vector.
Resources

Keep exploring

API ReferencePython SDK (PyPI)TypeScript SDK (npm)GitHub