Reference

Look-up pages: exhaustive, alphabetical where order doesn't matter, and honest about defaults. The API sub-pages document the OpenAI-compatible surface and the native REST endpoints.

00hal0 CLI referenceComplete reference for the hal0 CLI — every top-level command and sub-app, exact flags and defaults, verified against src/hal0/cli in the v1.0 tree.reference/cli.mdx01Config schema referenceEvery config file hal0 reads, every key, type, default, and constraint — verified against src/hal0/config/schema.py in the v1.0 tree.reference/config-schema.mdx02Environment variables referenceEvery environment variable hal0 reads, its default, and what it controls — verified by grepping os.environ/os.getenv across src/hal0 in the v1.0 tree.reference/env-vars.mdx03Paths & files referenceEvery filesystem path hal0 creates, reads, or writes — canonical resolver in src/hal0/config/paths.py, verified against the v1.0 tree.reference/paths-and-files.mdx04Hardware matrix referenceHow hal0 probes hardware, the canonical device taxonomy, and the backend-selection decision tree — verified against src/hal0/hardware and src/hal0/model_meta in the v1.0 tree.reference/hardware-matrix.mdx05Model roster & benchmarks referenceThe model registry, curated catalogue, hardware-driven recommendation logic, and the bench/ benchmark pipeline — verified against src/hal0/registry, src/hal0/hardware, and src/hal0/bench in the v1.0 tree.reference/model-roster-benchmark.mdx06Providers, profiles & devices referenceDisambiguates hal0's two unrelated 'provider' concepts, the profile template system, and the canonical device taxonomy — verified against src/hal0/providers, src/hal0/upstreams, src/hal0/profiles, and src/hal0/model_meta in the v1.0 tree.reference/providers-profiles-devices.mdx07Slot lifecycle referenceThe slot state machine — every state, every legal transition, dispatch ranking, typed errors, and the v1.0 write-boundary guard — verified against src/hal0/slots/state.py in the v1.0 tree.reference/slot-lifecycle.mdx08MCP tools referenceEvery MCP tool hal0 exposes over hal0-admin and hal0-memory, gating rules, and how hal0 acts as an MCP client — verified against src/hal0/mcp in the v1.0 tree.reference/mcp-tools.mdx09OpenAI-compatible API referenceEvery /v1/* endpoint hal0 serves, hal0-specific request/response deviations, and model-to-slot resolution — verified against src/hal0/api/routes/v1.py and src/hal0/dispatcher in the v1.0 tree.reference/api/openai-compat.mdx10Streaming referenceHow hal0 forwards streaming (SSE) responses — verified against src/hal0/dispatcher/router.py and src/hal0/api/routes/v1.py in the v1.0 tree.reference/api/streaming.mdx11Addressing a slot as a modelHow to target a specific slot by name from an OpenAI-compatible request — verified against src/hal0/dispatcher/_capability_resolve.py and src/hal0/api/routes/v1.py in the v1.0 tree.reference/api/slot-as-model.mdx12REST API indexIndex of hal0's HTTP /api/* management surface, router group by router group — verified against src/hal0/api/routes and the tool-to-route map in src/hal0/mcp/admin.py.reference/api/rest-api.mdx