🍳 Floe Cookbook

Reference AI agents built on Floe — the spend layer for agents. One Floe key pays every vendor, with programmable spend controls.

Website · Dashboard · Docs · Quickstart

---

What is this?

A cookbook of small, self-contained reference agents that show Floe in real frameworks — Vapi, LangChain, CrewAI, Coinbase AgentKit, MCP, the OpenAI Agents SDK, and plain SDKs. Each folder is an independent example you can read, copy, and run on its own. This is a gallery, not a template — there's nothing to clone wholesale; pick the recipe closest to what you're building.

Floe is the spend/billing layer for AI agents. It's walletless and priced in USD. One Floe key pays every vendor your agent uses — the model, memory, tools, and 2,000+ x402 API services — through a single endpoint, governed by programmable, context-aware spend controls. That's unified billing for agents: rail-agnostic, one key, one ledger, no per-vendor accounts, no crypto.

Start free. Create an agent key at the dashboard, fund it with a card, and your agent makes its first paid API call in minutes.

What you can build

• Voice agents that pay per-lookup for live web search and stop cleanly at a budget — vapi-voice-agent, vapi-venice-voice-agent — or that remember callers across calls via HydraDB — hydra-memory-agent
• Budget-capped multi-agent crews where a runaway loop dies at $1, not $414 — crewai-demo
• Metered LLM access — any OpenAI/Anthropic model behind one billed endpoint with a server-side cap — metered-llm
• Conversational agents that pay x402 APIs from natural language — langchain-agent
• Zero-install access from Claude Desktop / Cursor via hosted MCP — mcp-demo
• On-chain / self-custody agents — treasury, yield, and flash-loan strategies — yield-optimizer, flash-arb-bot

Examples

Example	Language	Framework / Stack	Difficulty	What it shows	Link
metered-llm	TypeScript · Python	OpenAI SDK (framework-agnostic)	Beginner	Route any OpenAI/Anthropic model through Floe's metered proxy — per-token billing on one key, capped server-side, your provider key never stored.	→
x402-client	TypeScript	Coinbase AgentKit	Beginner	The minimal payment example: delegate credit to the Floe facilitator, then call any x402 API with automatic, gas-free payment.	→
mcp-demo	Config only	Claude Desktop / Cursor (MCP)	Beginner	Connect Claude Desktop or Cursor to Floe's hosted MCP server in one line — read markets, intents, and loans with zero install.	→
langchain-agent	Python	LangChain	Beginner	A LangChain agent that exposes Floe actions as tools — check markets, borrow, monitor, and repay in natural language.	→
openai-agents	Config only	OpenAI Agents SDK	Beginner (Preview)	Use Floe from the OpenAI Agents SDK today via MCP fallback, ahead of the native adapter.	→
crewai-demo	Python	CrewAI · crewai-floe	Intermediate	Per-agent budgets with a hard, server-side ceiling: a rigged loop halts at $1, and a procurement crew enforces allowlists and per-role caps.	→
vapi-voice-agent	TypeScript	Vapi · GPT-4o · ElevenLabs · Exa	Intermediate	An outbound voice concierge that pays for live web search through Floe, tapers as it nears its budget, and audibly hard-stops at the cap.	→
yield-optimizer	TypeScript	Coinbase AgentKit	Intermediate	A treasury agent that borrows USDC against WETH, deploys to a yield strategy, monitors loan health, and repays. On-chain / self-custody.	→
vapi-venice-voice-agent	TypeScript	Vapi · Venice · ElevenLabs · Exa	Advanced	Same voice concierge, but the LLM inference itself runs on Venice through Floe — model and tools metered on one key, with an audible hard-stop.	→
hydra-memory-agent	TypeScript	Vapi · Venice · HydraDB	Advanced	A voice concierge with persistent memory — it stores caller facts in HydraDB and recalls them, so a later call greets you by name. Brain (Venice) + memory (HydraDB) on one Floe key, no vendor keys.	→
flash-arb-bot	TypeScript	Coinbase AgentKit	Advanced	On-chain flash-loan arbitrage across Aerodrome pools — a crypto-native / MEV strategy on Floe's lending surface.	→

Difficulty is a rough guide: Beginner = a key and a few minutes; Intermediate = a webhook, a framework, or a running server; Advanced = self-custody / on-chain setup (a funded wallet, an RPC endpoint). Some on-chain examples exercise Floe's lending surface — check each README for its current run status.

Demos

Two of the most-requested flows, end to end. Click a card to watch (~90s each).

Venice voice agent — model and tools on one Floe key

A phone call where the LLM inference and the paid web-search tools both meter on a single Floe key — tapering as the budget runs down to an audible hard-stop. See vapi-venice-voice-agent.

Persistent-memory voice concierge — recall across calls

The agent stores caller facts in HydraDB and recalls them on a later call — brain (Venice) + memory (HydraDB) on one Floe key, no vendor keys. See hydra-memory-agent.

Quickstart

Every example is standalone. Pick one, cd into it, and follow its README.

git clone https://github.com/Floe-Labs/floe-cookbook.git
cd floe-cookbook

# Pick an example — e.g. the minimal x402 payment client
cd x402-client
cp .env.example .env          # fill in FLOE_API_KEY (and any keys the README lists)

# TypeScript examples
npm install && npx tsx index.ts

# Python examples (e.g. langchain-agent)
pip install -r requirements.txt && python agent.py

You'll need a Floe API key — get one at the dashboard and fund it with a card. No wallet or crypto required for the spend-layer examples; the on-chain examples list their extra prerequisites.

Contributing

New recipes are welcome. See CONTRIBUTING.md and the per-example README template at docs/EXAMPLE_TEMPLATE.md.

License

MIT © Floe Labs