Steerable¶
◆ The model-quality layer for local & cheap models ◆
Fewer hallucinations Smallest code Ready out of the box Componentized
79.0% on Terminal-Bench 2.1 with GLM-5.3-Flash. One command boots the full shell, or adopt any layer standalone.
79.0% Steerable + GLM-5.3-Flash
+23.6 vs Codex on the same GLM
229.9M input tokens per catalog run
One command, full agent
Chat, terminal, sandboxed sidecar, and any OpenAI-compat, Anthropic, or Gemini key — across browser, desktop, and CLI.
Embed a layer ↓git clone https://github.com/pathlyapp/steerable.git
cd steerable && pnpm install
pnpm agent-shell:web
# in your product repo, with src-tauri wired to the shell crate
pnpm tauri dev
npm install -g @steerable/agent-cli
steerable-cli login
steerable-cli run "summarize this repo"
Easy to integrate
Embed only the layer you need — a Python agent, React chat UI, or a Node.js agent. UI-only showcase: pnpm shell:dev.
from steerable_agent_runtime import ToolRouter, tool
from steerable_agent_protocol import ToolCall
router = ToolRouter()
@tool(router=router, description="Read a file by path")
async def read_file(path: str) -> dict:
return {"path": path, "content": open(path).read()}
result = await router.dispatch(
ToolCall(id="c1", name="read_file", arguments={"path": "README.md"})
)
# result.success, result.data, result.error — all typed.
# Bundle the sidecar binary into resources/python-runtime/<platform>/
pnpm add @steerable/agent-runtime
import { AgentRuntime } from '@steerable/agent-runtime';
const runtime = new AgentRuntime({ sidecarPath });
await runtime.start(); // spawn + lifecycle.ready handshake
const stream = await runtime.chatStream({
provider: 'openai_compat',
model: 'glm-5.3-flash',
baseUrl: process.env.GATEWAY_BASE_URL!,
apiKey: process.env.GATEWAY_API_KEY!,
messages: [{ role: 'user', content: 'hi' }],
});
for await (const event of stream.events) { /* typed SSEEvent stream */ }
One Rust CoreLoop drives both the desktop sidecar (stdio JSON-RPC) and the FastAPI server (SSE) over LoopEvent.
Core mechanisms
Built for imperfect models — deterministic tool recovery, grounding vetoes, and fail-closed confinement.
01 · Fewer hallucinations
Grounded, not guessed¶
Grounding judges, completion vetoes, and automatic recovery for malformed text tool calls.
02 · Smallest code
Built for vibe coding¶
The smallest code surface. Plain @tool functions, no graph DSL.
03 · Ready out of the box
Fail-closed by default¶
Seatbelt / bwrap / Windows confinement, 61-rule classifier, and egress proxy. Try the keyless live demo.
04 · Componentized
Take one layer, skip the rest¶
5 tiers, 15 packages, strict no-upward-imports. Adopt just the protocol, UI, or sidecar.
Architecture
Strict no-upward-imports rule — adopt any tier and inherit only what sits below it. Architecture spec
Click any tier to highlight its downward dependencies — no layer ever imports above itself.
| Package | Tier | What you get |
|---|---|---|
@steerable/agent-protocol · steerable-agent-protocol |
1 | SSEEvent, ToolCall / ToolResult, ChatMessage, Sidecar JSON-RPC types (codegen from spec/) |
@steerable/agent-harness · steerable-agent-harness |
2 | decide_tool_mode, consume_budget, next_retry_delay_ms, command-safety patterns |
steerable-agent-runtime · @steerable/agent-runtime |
3 | CoreLoop, 4-protocol LLMProvider, @tool, ToolRouter, SSE/stdio transports & sidecar lifecycle |
steerable-sidecar · steerable-egress-proxy |
3 | Portable CPython (<1s boot, signed & notarised) plus per-host CONNECT egress allow-list proxy |
@steerable/agent-ui |
4 | 7 core components (ChatPanel, MessageList, ToolCallRenderer, …) + 14 /cards + hooks + Tailwind preset |
@steerable/agent-shell · agent-shell-web · agent-shell-tauri · pack-sdk |
5 | Tauri + headless host shell, shared Node HostRuntime, sidecar supervision, product-neutral renderer |
@steerable/agent-cli · @steerable/runtime-<target> |
5 | CLI & TUI (steerable-cli login), auto-pulling the platform runtime and sharing the host DB |
How common frameworks compare
Terminal-Bench 2.1 (89 tasks). 79.0% is GLM-5.3-Flash @max (3-run mean); charts compare single n=1 runs. Methodology
Tasks solved out of 89. Hover any bar or filter above.
One run per cell at high effort (Qwen: medium). Run list and commit SHAs
Shape is model (circle GLM, square DeepSeek, diamond Qwen). Higher and further left is better.
OpenRouter list prices on the pinned host. Pricing formula
GLM-5.3-Flash @high (n=1): Steerable 79.8% · C* C* 77.5% · P* 73.0% · D* H* 66.3% · C* 56.2%.
Beyond pass rates — how Steerable compares on runtime form, loop events, sandbox, and model recovery:
| Dimension | Steerable | OpenAI Codex | DeepSeek Harness | LangGraph | OpenAI Agents SDK | Claude Code / Agent SDK |
|---|---|---|---|---|---|---|
| What you get | 5 modular tiers: signed desktop sidecar + FastAPI server + 14-card React UI over one wire protocol | Closed product family (CLI / IDE / cloud), not an embeddable UI/SDK stack | Plugin-based TS harness (Cordis) for CLI/Web; no standalone desktop sidecar | State-graph orchestration only; no built-in UI, sandbox, or desktop runtime | Server-side orchestration only; no desktop sidecar or React UI kit | Closed-source CLI + SDK bundle; cannot adopt individual layers |
| Cheap & local models | Built-in recovery: parses malformed text tool calls + grounding judge + completion veto (79.0% on Flash) | Assumes structured tool_calls |
Assumes structured tool_calls |
No built-in recovery — you own the loop and checks | Built for frontier models | Built for frontier Claude models |
| Model lock-in | Zero lock-in: OpenAI-compat (Ollama/vLLM), Responses, Anthropic, Gemini natively | Centered on Responses wire & OpenAI | Multi-model (focused on DeepSeek / standard wires) | Multi-model via your own SDK calls | Tied to OpenAI (other providers via LiteLLM) | Anthropic models only (via 8 backends) |
| Default sandbox & egress | Fail-closed by default: Seatbelt / bwrap / Windows + 61 rules + per-host CONNECT allow-list | Platform sandbox + approvals + managed proxy | sandbox.confine (fail-closed) |
None built-in (bring Docker / cloud sandbox) | Docker or hosted Sandbox Agents (no local Linux confinement) | CLI defaults fail-open (missing backend warns and proceeds) |
| TS + Python contract | Single JSON Schema codegen → TS/Zod + Pydantic, 15 lockstep packages + golden conformance tests | Generates TS types; separate SDK implementations | TS-first; Python SDK bridges via CLI/RPC | Separate Py / JS libraries; no shared schema codegen | Separate Py / TS libraries; no cross-language codegen | Publishes TS declarations only (sdk-tools.d.ts) |
| Trade-off | Native CoreLoop engine is closed-binary; early ecosystem (0.12.x) |
Huge real-world mileage, but monolithic product stack | Open-source, still public prerelease (0.2.x) |
Mature ecosystem, but loop guards & UI are DIY | Quick to start, lacks desktop & cross-tier plumbing | Feature-rich, but closed-source and Anthropic-only |
Trade-offs and when to pick which: Full comparison.
Who's using it
Production desktop shells and enterprise deployments.
DeepPath
deeppath.cc
Aroli
aroli.work
DPKGS
dpkgs.cn
IDEVault
idevault.com
E-Town Holdings