On this page

Configuration

Skryba has no configuration file. The CLI reads flags and environment variables; flags backed by clap environment bindings win over the environment. Skryba Desktop optionally supplies missing environment variables from ~/.config/skryba/env before spawning the CLI.

Model inference

Variable / flag Default Reader Meaning
BRAMA_URL / --brama-url https://brama.wisent.com src/main.rs base URL; Skryba appends /v1/chat/completions
BRAMA_TOKEN none; required for rewrite, train, benchmark src/brama.rs bearer client token
SKRYBA_MODEL / --model claude-code-subscription src/main.rs generator model sent to Brama
SKRYBA_JUDGE_MODEL / --judge-model generator model src/main.rs quality-judge model
SKRYBA_AGENT_ID unset src/brama.rs optional agent identity; pair with the secret
SKRYBA_AGENT_AUTH_SECRET unset src/brama.rs optional HMAC secret; pair with agent id

Agent id and secret are all-or-nothing. Empty strings count as unset.

Detector selection and cache

Variable / flag Default Reader Meaning
GPTZERO_API_KEY unset src/detectors.rs enables GPTZero
WINSTON_API_KEY unset src/detectors.rs enables Winston
ORIGINALITY_API_KEY unset src/detectors.rs enables Originality.ai
SAPLING_API_KEY unset src/detectors.rs enables Sapling
GPTZERO_API_URL https://api.gptzero.me/v2/predict/text src/detectors.rs endpoint override
WINSTON_API_URL https://api.gowinston.ai/v2/ai-content-detection src/detectors.rs endpoint override
ORIGINALITY_API_URL https://api.originality.ai/api/v3/scan src/detectors.rs endpoint override
SAPLING_API_URL https://api.sapling.ai/api/v1/aidetect src/detectors.rs endpoint override
SKRYBA_CACHE / --cache ~/.cache/skryba/detector-scores.sqlite3 src/main.rs SQLite score cache
--detectors infer from non-empty API keys src/main.rs, src/detectors.rs comma-separated provider names
--detector-interval-ms 250 src/main.rs minimum interval per detector

Endpoint overrides are primarily for controlled deployments and offline fixtures. The endpoint is part of the cache namespace, so an override cannot reuse a different endpoint's scores.

RentAHuman

Variable Default Reader Meaning
RENTAHUMAN_API_KEY none; required src/rentahuman.rs sent as X-API-Key
RENTAHUMAN_API_URL https://rentahuman.ai/api src/rentahuman.rs HTTPS base URL

The URL must have an HTTPS scheme and host, with no credentials, query, or fragment. The API key may not contain control characters.

Other CLI controls

These are flags rather than environment keys:

Flag Default Scope
--minimum-quality 0.90 global judge threshold
rewrite --candidates 8 candidates per chunk
rewrite --max-words-per-chunk 400 chunk budget
rewrite/train/benchmark --temperature 0.9 generator temperature
rewrite/train/benchmark/corpus --seed 42 deterministic local sampling/order

All command-specific defaults are in CLI reference, train and benchmark, and RentAHuman.

Desktop environment file

~/.config/skryba/env syntax:

# comments and blank lines are ignored
BRAMA_TOKEN=value
SAPLING_API_KEY=value

Each non-comment line is split at its first =. Key and value are trimmed. Empty keys and malformed lines are ignored. A variable already present in the app's launch environment wins; the file fills only missing keys. The CLI itself does not read this file.

Maintained as part of the website-owned Skryba documentation corpus.