Skip to content

The fastest, cheapest, most efficient open-source agent harness. Run more than 500 agents on a $10 VPS.

8.4 KB
Raw Blame

Cookbook

Executable recipes are indexed from their source headers. Each entry records the declared run mode and any named Embed feature required by the example. Full source includes the surrounding setup and assertions.

Polling and callback approvals with cancellation

Allow and deny real parked writes, then cancel an in-flight callback without losing its pending request.

Source · offline with loopback stubs; no live path.

Run: cargo run -p openhuman-embed --example approvals

Stable capability metadata before and after boot

Stable capability metadata before and after boot.

Source · offline with loopback stubs; no live path.

Run: cargo run -p openhuman-embed --example capability_report

Stateless completion without booting an agent runtime

Stateless completion without booting an agent runtime.

Source · offline; optional live via OPENHUMAN_EXAMPLE_LIVE=1 and BASE_URL/API_KEY/MODEL.

Run: cargo run -p openhuman-embed --example completer

Run and inspect an agent cron job

Run and inspect an agent cron job.

Source · offline; optional live via OPENHUMAN_EXAMPLE_LIVE=1 and BASE_URL/API_KEY/MODEL.

Run: cargo run -p openhuman-embed --example cron

Native custom providers, fallback and workload role pins

Inject deterministic native models and prove fallback and role selection without inference HTTP.

Source · offline; no live inference path.

Run: cargo run -p openhuman-embed --example custom_provider

Runtime defaults and per-agent overrides

Runtime defaults and per-agent overrides.

Source · offline; optional live via OPENHUMAN_EXAMPLE_LIVE=1 and BASE_URL/API_KEY/MODEL.

Run: cargo run -p openhuman-embed --example defaults_overrides

A per-agent post-turn hook observes completed turns

A per-agent post-turn hook observes completed turns.

Source · offline; optional live via OPENHUMAN_EXAMPLE_LIVE=1 and BASE_URL/API_KEY/MODEL.

Run: cargo run -p openhuman-embed --example hooks

Host tools and HostOnly keep the advertised tool catalog exact

Host tools and HostOnly keep the advertised tool catalog exact.

Source · offline with loopback stubs; no live path.

Run: cargo run -p openhuman-embed --example host_tools

Lean runtime without background services

Lean runtime without background services.

Source · offline with loopback stubs; optional live via OPENHUMAN_EXAMPLE_LIVE.

Run: cargo run -p openhuman-embed --example lean_headless

Linux agent fleet memory and latency

Measure retained runtime-owned agents using loopback inference and two worker threads.

Source · offline on Linux; use a fresh constrained cgroup for release measurements. · feature: mcp,storage-sqlite

Run: cargo run -p openhuman-embed --release --example linux_fleet --no-default-features --features mcp,storage-sqlite

Connect an actual MCP protocol stub over loopback

Connect an actual MCP protocol stub over loopback.

Source · offline with loopback stubs; no live path. · feature: mcp,storage-sqlite

Run: cargo run -p openhuman-embed --example mcp --features mcp,storage-sqlite

Tenant scoped memory facade with an in-memory engine

Tenant scoped memory facade with an in-memory engine.

Source · offline with loopback stubs; no live path.

Run: cargo run -p openhuman-embed --example memory

SaaS profiles isolate conversation history

SaaS profiles isolate conversation history.

Source · offline with loopback stubs; no live path. · feature: channels,storage-sqlite

Run: cargo run -p openhuman-embed --example profiles --features channels,storage-sqlite

Hello agent: a prompt in and a reply out

Hello agent: a prompt in and a reply out.

Source · offline; optional live via OPENHUMAN_EXAMPLE_LIVE=1 and BASE_URL/API_KEY/MODEL.

Run: cargo run -p openhuman-embed --example run_turn

Runtime lifecycle events and live hook registration

Observe ordered metadata and add/remove a runtime-wide hook while agents keep running.

Source · offline with a loopback provider; no live path.

Run: cargo run -p openhuman-embed --example runtime_events

Access tiers and explicit sandbox choices

Access tiers and explicit sandbox choices.

Source · offline with loopback stubs; no live path.

Run: cargo run -p openhuman-embed --example sandbox_access

Embed an agent behind a host-owned HTTP server

Embed an agent behind a host-owned HTTP server.

Source · offline; optional live via OPENHUMAN_EXAMPLE_LIVE=1 and BASE_URL/API_KEY/MODEL.

Run: cargo run -p openhuman-embed --example server

Copy a skill bundle into its agent workspace

Copy a skill bundle into its agent workspace.

Source · offline; optional live via OPENHUMAN_EXAMPLE_LIVE=1 and BASE_URL/API_KEY/MODEL. · feature: skills

Run: cargo run -p openhuman-embed --example skills --features skills

SQLite writes and MongoDB configuration through Embed

Open a real local SQLite backend and describe a MongoDB deployment without connecting.

Source · offline; optional live MongoDB with OPENHUMAN_EXAMPLE_MONGODB_URL and storage-mongodb. · feature: storage-sqlite

Run: cargo run -p openhuman-embed --example storage --features storage-sqlite

Streaming progress with a draining receiver

Streaming progress with a draining receiver.

Source · offline; optional live via OPENHUMAN_EXAMPLE_LIVE=1 and BASE_URL/API_KEY/MODEL.

Run: cargo run -p openhuman-embed --example streaming

Structured output parsed and checked against the request

Structured output parsed and checked against the request.

Source · offline with loopback stubs; no live path.

Run: cargo run -p openhuman-embed --example structured_output

Telegram channel answered by its bound agent via a local Bot API

Telegram channel answered by its bound agent via a local Bot API.

Source · offline with loopback stubs; no live path. · feature: channels

Run: cargo run -p openhuman-embed --example telegram --features channels

Two agents with independent prompts and working folders

Two agents with independent prompts and working folders.

Source · offline; optional live via OPENHUMAN_EXAMPLE_LIVE=1 and BASE_URL/API_KEY/MODEL.

Run: cargo run -p openhuman-embed --example two_agents