docs / first-time-setup

Eerste setup

Wat je direct na installatie doet, in de volgorde die het meeste oplevert. Vijf kleine stappen die een verse install in iets nuttigs veranderen.

1. Verbind Ollama

Soriku detecteert automatisch een lokale Ollama-install op http://localhost:11434. Als je al modellen gepulled hebt verschijnen die in de modellenlijst. Zo niet, pull er minstens één.

ollama pull qwen2.5-coder:7b

2. Draai de capability-benchmark

Bij eerste gebruik draait Soriku op bootstrap-scores zodat hij meteen kan routeren. Voor routing afgestemd op jouw specifieke hardware draai je de lokale benchmark.

# quick mode: ~4 minuten per model
python -m benchmarks --quick
# volledige sweep: ~15 minuten per model
python -m benchmarks

Resultaten komen terecht in benchmarks/results/capability_map.json. De router pakt ze op bij de volgende prompt.

3. Voeg een externe provider toe (optioneel)

Breng je eigen keys voor Claude, OpenAI, Mistral, Groq of Gemini in als je wil dat Soriku ze meeneemt in de routing. Keys blijven in je lokale keystore, tenzij je expliciet hosted Soriku Cloud gebruikt.

Externe provider toevoegen →

4. Kies of bouw agent persona's

Soriku komt met 15 ingebouwde persona's: code architect, code reviewer, backend developer, frontend developer, devops engineer, data analyst, researcher, creative writer, editor en meer. Je kan ze direct gebruiken of forken naar je eigen versie.

Bekijk de ingebouwde persona's →

5. Koppel je editor

Soriku spreekt Model Context Protocol, dus Cursor, VS Code en andere MCP-aware tools kunnen hem direct gebruiken zonder een extra adapter.

Sanity-check
Open de chat-UI op http://localhost:8765, vraag Wat voor model ben je? en verifieer dat de response-footer toont welk model antwoordde en waarom het gekozen werd. Als de routing er vreemd uitziet, zie Routing werkt niet.