Installatie
Kies het install-pad dat past bij hoe je Soriku wil draaien: native Python op je machine, Docker, of later een managed cloud.
Systeemvereisten
| Onderdeel | Minimum | Aanbevolen |
|---|---|---|
| CPU | Apple Silicon of x86_64 | Apple Silicon M-serie of AMD/Intel met AVX2 |
| RAM | 8 GB | 16 GB unified memory of meer |
| Disk | 1 GB voor de app | 4–40 GB voor modellen, afhankelijk van wat je pulled |
| GPU | Optioneel | Metal / CUDA / ROCm voor snellere lokale inference |
| Network | Niet vereist voor local mode | Alleen nodig voor externe providers en updates |
| OS | macOS 12+, Linux, Windows 11 | macOS 14+ (best getest) of Ubuntu 22.04+ |
Native Python install
Het meest flexibele pad. Jij hebt controle over de Python-versie, de virtualenv en welke dependencies je binnenhaalt.
git clone https://github.com/atypisch/soriku.git
cd soriku
python -m venv .venv && source .venv/bin/activate
pip install -e ".[all]"
# verifieer
python -c "import core; print(core.__version__)"
python server.py
Install-extras
De pyproject.toml definieert een handvol optionele groepen zodat je de installatie klein kan houden.
| Extra | Bevat | Wanneer gebruiken |
|---|---|---|
[server] | FastAPI, Uvicorn, SSE-streaming | Minimum om de HTTP-server te draaien |
[mcp] | MCP SDK en stdio-transport | Wanneer je Soriku wil koppelen aan Cursor of VS Code |
[documents] | PDF-, DOCX-, EPUB-parsing | Wanneer je agents in pilot mode documenten wil laten lezen |
[billing] | Stripe SDK en webhook-handlers | Alleen voor hosted Soriku Cloud met betaalde plannen |
[voice] | Whisper (CPU) en audio-decoders | Voor het /api/v1/voice endpoint |
[all] | Alles hierboven | Standaard voor development en de meeste gebruikers |
Docker
Komt met een docker-compose.yml die Soriku en Ollama samen opstart in twee containers.
docker compose up -d
# pull een model in de ollama-container
docker compose exec ollama ollama pull qwen2.5-coder:7b
# logs
docker compose logs -f soriku
Op macOS draait Docker in een Linux-VM, dus Metal GPU-acceleratie is niet beschikbaar binnen de container. Voor lokale ontwikkeling op Apple Silicon is de native Python-installatie veel sneller.
Verifieer de install
# server moet live zijn
curl -s http://localhost:8765/api/health | jq
# OpenAI-compatible endpoint moet reageren
curl -s http://localhost:8765/api/v1/models | jq
Updaten
cd soriku
git pull
pip install -e ".[all]" --upgrade
Database-migraties draaien automatisch bij de volgende serverstart. Je agent persona's, capability map en routing-logs blijven staan waar ze stonden.