Getting Started¶

Quick start¶

./scripts/install.sh
source .venv/bin/activate
python cli/run.py --reload

The default base URL is http://localhost:59213.

Swagger UI: http://localhost:59213/skill_runtime/docs
OpenAPI JSON: http://localhost:59213/skill_runtime/openapi.json
Liveness: http://localhost:59213/health/live
Readiness: http://localhost:59213/health/ready
Execution API: http://localhost:59213/v1/skills/execute

Configuration¶

SKILL_ENVIRONMENT=local
SKILL_HOST=0.0.0.0
SKILL_PORT=59213
SKILL_LOG_LEVEL=info
SKILL_REQUEST_TIMEOUT_SECONDS=8
SKILL_ENGINE_EXECUTE_URL=http://sohri-skill-engine:8000/v1/skills/execute

Calling the API¶

curl -X POST http://localhost:59213/v1/skills/execute \
  -H 'Content-Type: application/json' \
  -d '{
    "skill_id": "sample-skill",
    "arguments": {"query": "example"},
    "context": {}
  }'

CLI¶

python -m cli.main serve --reload
python -m cli.main test
python -m cli.main openapi --output docs/openapi.json
python -m cli.main smoke \
  --skill-id sample-skill \
  --arguments '{"query":"example"}'

Checks¶

python cli/test.py
ruff check cli skills version.py
helm lint deploy
docker compose config --quiet

Docker¶

docker compose up --build

Helm¶

helm upgrade --install sohri-skill-runtime deploy \
  --namespace mago-prod \
  --create-namespace \
  -f deploy/values-onprem.yaml

See Deployment and operations for production deployment.