iii-hq / iii
iii (pronounced “three eye”) unifies your existing backend stack with a single engine and three primitives: Function, Worker, and Trigger.
AI Architecture Analysis
This repository is indexed by RepoMind. By analyzing iii-hq/iii in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.
Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context on-demand, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.
Embed this Badge
Showcase RepoMind's analysis directly in your repository's README.
Repository Overview (README excerpt)
Crawler viewWhat is iii You start building a backend and immediately need six different tools: an API framework, a task queue, a cron scheduler, pub/sub, a state store, and an observability pipeline. Each has its own config, its own deployment, its own failure modes. A simple "process this, then notify that" workflow touches three services before you write any business logic. iii replaces all of that with a single engine and three primitives: **Function**, **Trigger**, and **Worker**. A Function is anything that does work. A Trigger is what causes it to run - an HTTP request, a cron schedule, a queue message, a state change. A Worker connects your functions to the engine. You write the function, declare what triggers it, connect a worker, and the engine handles routing, retries, and observability. One config file. One process. Everything discoverable. Think of it the way React gave frontend a single model for UI - iii gives your backend a single model for execution. Three Concepts | Concept | What it does | | ------------- | ------------ | | **Function** | A unit of work. It receives input and optionally returns output. It can exist anywhere: locally, in the cloud, on serverless, or as a third-party HTTP endpoint. | | **Trigger** | What causes a Function to run - explicitly from code, or automatically from an event source. Examples: HTTP route, cron schedule, queue topic, state change, stream event. | | **Worker** | The runtime that connects your functions and triggers to the engine. Workers register and deregister themselves without configuration. Once connected, their functions are available across the entire backend. | Quick Start Your engine is running at with HTTP API at . For a project-backed setup, create in your working directory or pass . Connect a worker Your function is now live at . Python Rust SDKs | Language | Package | Install | | -------- | -------------------------------------------------- | --------------------- | | Node.js | | | | Python | | | | Rust | | Add to | Console The iii-console is a developer and operations dashboard for inspecting functions, triggers, traces, and real-time state. Repository Structure | Directory | What it is | README | | -------------- | ------------------------------------------------------- | --------------------------------------- | | | iii Engine (Rust) - core runtime, modules, and protocol | engine/README.md | | | SDKs for Node.js, Python, and Rust | sdk/README.md | | | Developer dashboard (React + Rust) | console/README.md | | | Higher-level frameworks built on the SDK | frameworks/motia/ | | | iii website | website/ | | | Documentation site (Fumadocs/MDX) | docs/README.md | See STRUCTURE.md for the full monorepo layout, dependency chain, and CI/CD details. Examples See the Quickstart guide for step-by-step tutorials. Resources • Documentation • CLI • Console • Examples • Contributing License The iii project uses a dual licensing model: | Directory | License | | ---------------- | -------------------- | | | Elastic License 2.0 | | | Apache License 2.0 | | | Apache License 2.0 | | | Apache License 2.0 | | | Apache License 2.0 | | | Apache License 2.0 | | | Apache License 2.0 | The engine runtime is licensed under the Elastic License 2.0 (ELv2). All SDKs, frameworks, CLI, console, documentation, and the website are licensed under the Apache License 2.0. See NOTICE.md for details.