Valori LogoValori

Quickstart

Install an SDK, authenticate, and make your first request.

1. Install

# No installation required — plain HTTPS

2. Authenticate

Both SDKs take your API key alone — no project_id, no node URL. See Authentication for how this resolves.

from valori import ValoriClient

client = ValoriClient(api_key="vlk_your_project_api_key")

3. Create a collection

curl -X POST "https://app.valori.systems/v1/namespaces" \
-H "Authorization: Bearer vlk_your_project_api_key" \
-H "Content-Type: application/json" \
-d '{"name": "documents", "dimension": 8, "metric": "squared_l2"}'

4. Insert and search

collection = client.collection("documents")
collection.records.insert([0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8])
hits = collection.search([0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8], k=5)

5. Clean up

client.collections.delete("documents")

Next steps