Begin met de quickstart en houd de referentie bij de hand.
De volledige reference staat op soriku.com/docs. De quickstart hieronder dekt negentig procent van wat je op dag één doet, in vijf minuten.
Quickstart · 5 minuten
1. Installeer
Download de desktop-app voor macOS en open hem. De engine zit erin.
2. Verbind Ollama
Soriku detecteert lokale Ollama automatisch. Of plak een externe API-key.
3. Draai de benchmark
Duurt ongeveer 4 minuten per model. Zet je capability map op.
4. Vraag wat dan ook
Open de chat of hit het OpenAI-compatible endpoint.
5. Bouw een agent
Maak een persona, geef het tools, deel met je team.
Drop-in voor de OpenAI SDK.
Verander de base URL en je bent klaar. Het werkt met elke SDK die de OpenAI-API spreekt, van Cursor tot je eigen scripts.
Model auto laat de keuze aan de capability map. Noem een model en Soriku gebruikt dat model.
from openai import OpenAI
client = OpenAI(
base_url="http://localhost:8765/api/v1",
api_key="local",
)
reply = client.chat.completions.create(
model="auto",
messages=[{"role": "user", "content": "Summarise this contract"}],
)Alles wat je code moet weten.
Soriku draait een lokale server op poort 8765 die de OpenAI-API spreekt. Wijs je SDK ernaar en elk verzoek gaat via de capability map, tenzij je zelf om een model vraagt.
- Base URL
- http://localhost:8765/api/v1
- Authenticatie
- Bearer soriku-local
- Endpoints
- /chat/completions · /models · /embeddings
- Wie antwoordde
- response.model + x-soriku-route
- Privacy per verzoek
- x-soriku-zone: local | eu | any
- Tools en MCP
- mcp://localhost:8765
Op een teamserver gebruik je het adres in je eigen netwerk in plaats van localhost. Soriku EU heeft per workspace een eigen URL.
Lokaal werkt elke key. Op een server of in Soriku EU maak je keys per persoon of per app, en die trek je los van elkaar in.
Chat, de lijst met modellen en hun gemeten scores, en embeddings voor je eigen zoekfunctie. Streaming werkt zoals in de OpenAI-API.
Het antwoord noemt het model dat antwoordde. De header vertelt waarom: de categorie, de score en de privacyregel die gold.
Dwing af dat een verzoek op deze machine of in de EU blijft, wat de standaard ook is. Kan dat niet, dan wordt het verzoek geweigerd en niet omgeleid.
Soriku is ook een MCP-server. Gekoppelde tools zijn alleen beschikbaar voor modellen binnen je allowlist, en elke call komt in het log.