Skip to main content
These templates are working examples in the examples/ directory. Each follows the standard aixyz app/ directory structure and can be run locally.

​
Running a Template

cd examples/boilerplate
bun install
bun run dev
The agent starts at http://localhost:3000 with all protocol endpoints enabled.

​
Basic

Standard agents using app/agent.ts + app/tools/. No custom server — the server is auto-generated by the build pipeline. Start here.

Boilerplate

Unit conversion agent with length, weight, and temperature tools.

Flight Search

Flight search with Skyscanner API and Stripe payments.

Chainlink

Chainlink price feeds on Ethereum mainnet.

​
Advanced

Custom server wiring, bring-your-own payment facilitator, and testing patterns. These templates demonstrate how to take full control of the aixyz server.

Sub-Agents

Multiple A2A endpoints from one deployment using app/agents/[name].ts.

Custom Server

Manual server control with app/server.ts — wire A2A, MCP, and x402 yourself.

BYO Facilitator

Bring-your-own x402 facilitator via app/accepts.ts.

Agent with Tests

Testing patterns with bun:test — deterministic and non-deterministic tests.

Fake Model Agent

Fully deterministic testing with fake() — no API key required.

Express Integration

Mount AixyzApp as Express middleware alongside your own routes.

x402 Sessions

Payer-scoped session storage with x402 payment identity.