Xybrid

CLI

Install and use the Xybrid command-line interface

The xybrid CLI runs models and pipelines from the terminal — the fastest way to try a model before integrating an SDK.

Installation

# macOS / Linux
curl -sSL https://raw.githubusercontent.com/xybrid-ai/xybrid/master/install.sh | sh
# Windows (PowerShell)
irm https://raw.githubusercontent.com/xybrid-ai/xybrid/master/install.ps1 | iex

The script detects your platform and installs the latest release binary.

Pre-built binaries

Download binaries for macOS (arm64), Linux (x86_64), and Windows (x86_64) from GitHub Releases.

From source

cargo install --git https://github.com/xybrid-ai/xybrid xybrid-cli --features platform-macos

Replace platform-macos with platform-desktop on Linux/Windows.

Verify

xybrid --help
xybrid models list

Commands

CommandPurpose
xybrid runRun a model or pipeline (text, audio, LLM)
xybrid replInteractive chat that keeps the model loaded, with tool calling (--stream, --system, --tools-file)
xybrid modelsBrowse the registry: list, search <query>, info <id>, voices <id>
xybrid fetchPre-download models to the local cache
xybrid cacheManage the local cache: list, status, clear [id]
xybrid prepareParse and validate a pipeline YAML
xybrid planShow the execution plan: models, targets, download status
xybrid traceAnalyze an explicitly exported OTLP/JSON trace
xybrid initGenerate model_metadata.json for a model directory
xybrid packCreate a .xyb bundle from a model directory
xybrid bundleFetch a registry model and produce a .xyb bundle
xybrid telemetryManage registry telemetry settings
xybrid connectConnect a project to a claimable Xybrid workspace and save its key, with no sign-up
xybrid authInspect, recover or forget the project's saved credentials: status, claim, logout

Common workflows

# Text-to-speech
xybrid run --model kokoro-82m --input-text "Hello from Xybrid!" -o hello.wav

# Speech-to-text
xybrid run --model whisper-tiny-ggml --input-audio recording.wav

# Chat with a local LLM (streaming)
xybrid repl --model qwen2.5-0.5b-instruct --stream

# Run a GGUF straight from HuggingFace
xybrid run --huggingface bartowski/google_gemma-3-1b-it-GGUF --input-text "Hi!"

# Pre-download for offline use
xybrid fetch --model kokoro-82m

Global flags

FlagEnvironment variableDescription
--api-keyXYBRID_API_KEYCloud API key; does not enable observability by itself. When neither is set, the key saved by xybrid connect is used
--platform-urlXYBRID_PLATFORM_URLCloud gateway URL (default https://api.xybrid.dev)
--observability—Opt into Xybrid trace export; requires an API key
--traces-endpoint—Full trace URL for --observability (default https://ingest.xybrid.dev/v1/traces)
--device-idXYBRID_DEVICE_IDStable device identifier for telemetry
-v, -vv—Verbose output (-vv includes library logs)
-q—Quiet mode (errors only)

For a Collector, configure OTEL_EXPORTER_OTLP_ENDPOINT or per-signal OTEL_EXPORTER_OTLP_*_ENDPOINT variables. This enables export independently of cloud authentication. OTEL_SDK_DISABLED=true disables export in either mode. The CLI flushes and shuts down its exporter when the command ends. Enabled observability captures prompts and outputs by default. Set OTEL_INSTRUMENTATION_GENAI_CAPTURE_CONTENT=no_content for metadata only. See API keys for key scopes and what gets exported.

On this page