iii Examples

February 26, 2026 ยท View on GitHub

Official examples for the iii engine.

License

Prerequisites

Install the iii engine:

curl -fsSL https://install.iii.dev/iii/main/install.sh | sh

Verify:

iii --version

Examples

ExampleDescription
api-frameworks-orchestrationRun 4 API frameworks (Express, Fastify, Hono, Koa) in a single file
api-frameworks-workersRun 4 API frameworks as separate workers
api-frameworks-auto-registerAuto-registration + shared context (logging, state, request tracking)
iii-vs-traditionalSide-by-side: connect a Python service with iii (~120 lines) vs traditional gateway (~465 lines)

Quick Start

git clone https://github.com/iii-hq/iii-examples.git
cd iii-examples

cd examples/api-frameworks-orchestration
npm install

# Start the iii engine in a separate terminal
iii

# Run the example
npm run dev

How It Works

  1. Workers connect to the iii engine via WebSocket
  2. Functions are registered with the engine
  3. Triggers (HTTP, cron, queue, stream) invoke functions

SDK Quick Reference

SDKInitConnect
Node.jsconst iii = init('ws://localhost:49134')Auto on init()
Pythoniii = III('ws://localhost:49134')await iii.connect() required
Rustlet iii = III::new("ws://127.0.0.1:49134")iii.connect().await? required

Resources

License

Apache 2.0