{"id":44572258,"url":"https://github.com/iii-hq/iii","last_synced_at":"2026-05-26T22:01:47.047Z","repository":{"id":279824117,"uuid":"911303109","full_name":"iii-hq/iii","owner":"iii-hq","description":"Effortlessly compose, extend, and observe every service in real-time for the first time ever.","archived":false,"fork":false,"pushed_at":"2026-05-25T20:39:34.000Z","size":559613,"stargazers_count":16076,"open_issues_count":40,"forks_count":1068,"subscribers_count":77,"default_branch":"main","last_synced_at":"2026-05-25T22:12:10.862Z","etag":null,"topics":["agents","ai","api","backend","developer-tools","framework","genai","javascript","primitives","python","rust","typescript"],"latest_commit_sha":null,"homepage":"https://iii.dev","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/iii-hq.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.spdx","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-01-02T17:45:02.000Z","updated_at":"2026-05-25T22:07:37.000Z","dependencies_parsed_at":"2025-02-27T23:24:37.387Z","dependency_job_id":"da3930c8-62ee-434d-bcbc-79e7fc0efd83","html_url":"https://github.com/iii-hq/iii","commit_stats":null,"previous_names":["motiadev/motia","iii-hq/iii"],"tags_count":291,"template":false,"template_full_name":null,"purl":"pkg:github/iii-hq/iii","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iii-hq%2Fiii","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iii-hq%2Fiii/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iii-hq%2Fiii/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iii-hq%2Fiii/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iii-hq","download_url":"https://codeload.github.com/iii-hq/iii/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iii-hq%2Fiii/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33540617,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"ssl_error","status_checked_at":"2026-05-26T15:22:15.568Z","response_time":63,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents","ai","api","backend","developer-tools","framework","genai","javascript","primitives","python","rust","typescript"],"created_at":"2026-02-14T03:23:52.476Z","updated_at":"2026-05-26T22:01:47.040Z","avatar_url":"https://github.com/iii-hq.png","language":"Rust","funding_links":[],"categories":["AI \u0026 LLM","Rust","Libraries","TypeScript","\u003ca name=\"Rust\"\u003e\u003c/a\u003eRust","AI Agent Frameworks \u0026 SDKs","⚙️ Backend \u0026 APIs"],"sub_categories":["Agents \u0026 Orchestration","Asynchronous","Multi-Agent Collaboration Systems"],"readme":"# iii\n\n![iii: point-to-point integrations vs zero-integration via shared runtime](.github/assets/zero-integration.png)\n\n[![Engine License](https://img.shields.io/badge/engine-ELv2-blue.svg)](engine/LICENSE)\n[![SDK License](https://img.shields.io/badge/sdk-Apache--2.0-green.svg)](sdk/LICENSE)\n[![Docker](https://img.shields.io/docker/v/iiidev/iii?label=docker)](https://hub.docker.com/r/iiidev/iii)\n[![npm](https://img.shields.io/npm/v/iii-sdk?label=npm)](https://www.npmjs.com/package/iii-sdk)\n[![PyPI](https://img.shields.io/pypi/v/iii-sdk?label=pypi)](https://pypi.org/project/iii-sdk/)\n[![Crates.io](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fcrates.io%2Fapi%2Fv1%2Fcrates%2Fiii-sdk\u0026query=%24.crate.max_stable_version\u0026label=crates.io\u0026prefix=v\u0026color=orange)](https://crates.io/crates/iii-sdk)\n\n## What is iii?\n\niii is the easiest way to compose, extend, and observe every service in your stack in real time.\n\nEvery backend starts as a project before the first line of business logic. Queues, cron, HTTP,\nstate, observability, agents, and sandboxes each usually bring their own integration story. iii\ncollapses that into one live system surface.\n\n```bash\niii worker add queue\niii worker add agent\niii worker add sandbox\niii worker add \u003canything\u003e\n```\n\nEach worker joins the live catalog. Every other worker is notified and can call it immediately.\nBrowse available workers at [workers.iii.dev](https://workers.iii.dev/).\n\nThat is the agent story too: when a task needs a capability the system does not have, an agent can\nadd a worker, discover its functions, call them, and trace what happened. Same interface a developer\nuses.\n\n### Three Primitives\n\nWorker _ Function _ Trigger is the entire mental model.\n\n**Workers** are processes that register with the iii engine and then register triggers and\nfunctions. A TypeScript API service is a worker. A Python data pipeline is a worker. A Rust\nmicroservice is a worker. Any functionality can be transformed into a worker with a few lines of\ncode. Workers can also create other workers at runtime, so agents and applications can extend the\nsystem while it is running.\n\n**Triggers** are anything that causes a function to run. A trigger can be a direct call to a\nfunction, an HTTP endpoint, a cron schedule, a queue subscription, a state change, a stream event,\nor anything else. Triggers are declarative: the Worker defines \"this function runs when this thing\nhappens,\" and iii handles routing, serialization, and delivery.\n\n**Functions** are units of work with a stable identifier (e.g., `content::classify`,\n`orders::validate`). It receives input, does work, and optionally returns output. Functions exist in\nworkers.\n\nBy mapping everything a service can do to these three primitives iii creates a development process\nthat is both effortlessly composable, and completely observable.\n\n## What Changes\n\nBefore iii:\n\n- New observability tool: uncountable integrations\n- New agent harness: separate retry config, separate traces, separate timeouts\n- New queue: vendor evaluation, procurement, and weeks of integration\n\nAfter iii:\n\n- `iii worker add observability`\n- `iii worker add queue`\n- Done. It is in the system, traceable, and callable.\n\nPlatform teams publish workers. Application teams register functions and declare triggers. Agents\nuse the same catalog and the same function calls.\n\nExtending iii is `iii worker add`. Composing iii is calling functions. Observing iii is opening the\ntrace.\n\n## Quick Start\n\n```bash\niii project init myapp    # scaffold a project\ncd myapp\niii                       # start the engine\n```\n\nNeed to install `iii` first? Full walkthrough at the\n[Quickstart guide](https://iii.dev/docs/quickstart).\n\n## Add Workers\n\nInstall new capabilities into a project with `iii worker add`:\n\n[![Adding a worker with iii worker add](.github/assets/workers-add.gif)](https://workers.iii.dev/)\n\n## SDKs\n\n| Language | Package                                            | Install                                     |\n| -------- | -------------------------------------------------- | ------------------------------------------- |\n| Node.js  | [`iii-sdk`](https://www.npmjs.com/package/iii-sdk) | `pnpm add iii-sdk` or `npm install iii-sdk` |\n| Python   | [`iii-sdk`](https://pypi.org/project/iii-sdk/)     | `pip install iii-sdk`                       |\n| Rust     | [`iii-sdk`](https://crates.io/crates/iii-sdk)      | Add to `Cargo.toml`                         |\n\n## Agent Skills\n\nInstall iii's agent-readable reference material:\n\n```bash\nnpx skills add iii-hq/iii/skills\n```\n\nSkills cover every iii primitive: HTTP endpoints, queues, cron, state, streams, custom triggers, and\nmore. See [skills/](skills/) for the full list.\n\n## Console\n\nThe [iii-console](console/) is a developer and operations console for inspecting workers, functions,\ntriggers, queues, traces, logs, and real-time state. See the\n[Console docs](https://iii.dev/docs/console) for setup and usage.\n\n## Repository Structure\n\n| Directory  | What it is                                              | README                                 |\n| ---------- | ------------------------------------------------------- | -------------------------------------- |\n| `engine/`  | iii Engine (Rust) - core runtime, modules, and protocol | [engine/README.md](engine/README.md)   |\n| `sdk/`     | SDKs for Node.js, Python, and Rust                      | [sdk/README.md](sdk/README.md)         |\n| `console/` | Developer console (React + Rust)                        | [console/README.md](console/README.md) |\n| `skills/`  | Agent-readable reference material                       | [skills/README.md](skills/README.md)   |\n| `website/` | iii website                                             | [website/](website/)                   |\n| `docs/`    | Documentation site (Mintlify/MDX)                       | [docs/README.md](docs/README.md)       |\n\nSee [STRUCTURE.md](STRUCTURE.md) for the full monorepo layout, dependency chain, and CI/CD details.\n\n## Examples\n\nSee the [Quickstart guide](https://iii.dev/docs/quickstart) for step-by-step tutorials.\n\n## Resources\n\n- [Documentation](https://iii.dev/docs)\n- [CLI \u0026 Engine](https://github.com/iii-hq/iii)\n- [Console](console/)\n- [Examples](https://github.com/iii-hq/iii-examples)\n- [Contributing](CONTRIBUTING.md)\n\n## License\n\nThe iii is licensed as such:\n\n| Directory  | License                               |\n| ---------- | ------------------------------------- |\n| `engine/`  | [Elastic License 2.0](engine/LICENSE) |\n| `sdk/`     | [Apache License 2.0](sdk/LICENSE)     |\n| `console/` | [Apache License 2.0](console/LICENSE) |\n| `docs/`    | [Apache License 2.0](docs/LICENSE)    |\n| `website/` | [Apache License 2.0](website/LICENSE) |\n\nThe engine runtime is licensed under the Elastic License 2.0 (ELv2). All SDKs, CLI, console,\ndocumentation, and the website are licensed under the Apache License 2.0.\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for additional details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiii-hq%2Fiii","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiii-hq%2Fiii","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiii-hq%2Fiii/lists"}