iii
Effortlessly compose, extend, and observe every service in real-time for the first time ever.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/iii-hq/iii with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/iii-hq/iii'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/iii-hq-iii)HTML
<a href="/listings/iii-hq-iii"><img src="/api/listings/iii-hq-iii/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
These steps run a script from the network that findsafeskills does not scan.
Install `iii`:
curl -fsSL https://install.iii.dev/iii/main/install.sh | sh
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 174 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- <div align="center">
- # iii
- **More application. Less infrastructure.**
- Connect any functions, agents, APIs, models, browsers, infrastructure, and machines into one live, composable system.
- [](https://github.com/iii-hq/iii/stargazers)
- [](https://github.com/iii-hq/iii/actions/workflows/ci.yml)
- [](https://github.com/iii-hq/iii/releases)
- [](https://github.com/iii-hq/iii/graphs/contributors)
- [](#license)
- [](https://www.npmjs.com/package/iii-sdk)
- [](https://www.npmjs.com/package/iii-sdk)
- [](https://pypi.org/project/iii-sdk/)
- [](https://pypistats.org/packages/iii-sdk)
- [](https://crates.io/crates/iii-sdk)
- [](https://docs.rs/iii-sdk)
- [](https://pkg.go.dev/github.com/iii-hq/iii/sdk/packages/go/iii)
- [](https://hub.docker.com/r/iiidev/iii)
- [](https://discord.gg/iiidev)
- [](https://x.com/iiidevs)
- [Website](https://iii.dev) · [Docs](https://iii.dev/docs) · [Quickstart](https://iii.dev/docs/quickstart) · [Worker registry](https://iii.dev/registry) · [Blog](https://iii.dev/blog) · [Manifesto](https://iii.dev/manifesto)
- English | [简体中文](README_zh.md)
- </div>
- ## Why iii
- Every service comes with its own runtime, API, and failure modes. Getting services to work together means endless integration and instrumentation work: error handling, gateways, sync, tracing, and maintenance that never stops.
- It's estimated that up to 70% of development time is dedicated to integrations. 40% is the lowest estimate we could find.
- iii removes that work with one primitive, the **Function**. Services, agents, and tools connect to one engine as workers, and everything they can do is a Function that any other worker can call or observe, in any language and on any machine. Workers can then be defined in a Compose file and run on any infrastructure. An entire service stack can be brought up, down, upgraded, or swapped out with ease.
- iii is like having an entire app platform at your fingertips without the vendor lock-in. The result is a system that is composable, observable, discoverable, extensible, and reactive. See [Built for C.O.D.E.R.](#built-for-coder).
- ## One primitive: the Function
- iii organizes software around one primitive, the **Function**, and two operators:
- - `worker.call(a)` runs function `a` now.
- - `worker.observe(a, b)` makes function `b` run when function `a` runs.
- Workers host functions. Queues, databases, HTTP, streaming, sandboxes, observability, agents, and business logic are all functions. An HTTP request is a call of `http::on-request`. A database write is a call of `database::on-row-changed`. A queue message is a call of `queue::on-message`. To react to any of them, you use the same `observe`.
- ```typescript
- import { registerWorker } from 'iii-sdk'
- const worker = registerWorker('ws://localhost:49134')
- worker.registerFunction('orders::create', async (order: { item: string; total: number }) => {
- return { id: crypto.randomUUID(), ...order }
- })
- worker.registerFunction('alerts::big-order', async ({ input }: { input: { total: number } }) => {
- console.log(`Big order: ${input.total}`)
- })
- // When orders::create runs with a total of 500 or more, alerts::big-order runs
- const observer = worker.observe(
- { function_id: 'orders::create', filters: { 'input.total': { $gte: 500 } } },
- 'alerts::big-order',
- )
- await observer.ready()
- // Run orders::create now and wait for its result
- const order = await worker.call({ function_id: 'orders::create', payload: { item: 'widget', total: 750 } })
- console.log(order)
- ```
- The same API is in every SDK. See [sdk/README.md](sdk/README.md).
- ## Built for C.O.D.E.R.
- | | Property | What you get |
- | --- | --- | --- |
- | **C** | Composability | Functions in different languages and locations work together seamlessly. |
- | **O** | Observability | One trace follows every execution step across languages and machines. Export over OTLP. |
- | **D** | Discoverability | The engine holds a live registry of every Function. It's always up to date so developers and agents have a clear picture. |
- | **E** | Extensibility | Workers can be added and removed at any time with a single command. |
- | **R** | Reactivity | Anything can be an observer or observed. Reactivity and events do not need to be pre-planned. |
- ## Install
- ```bash
- curl -fsSL https://iii.dev/registry/install/iii/latest.sh | sh
- ```
- On Windows, in PowerShell:
- ```powershell
- irm https://iii.dev/registry/install/iii/latest.ps1 | iex
- ```
- The installer asks to set up your first project. Press Enter, then open http://127.0.0.1:3113.
- For CI, Docker builds, and scripts, install without the prompt:
- ```bash
- curl -fsSL https://iii.dev/registry/install/iii/latest.sh | sh -s -- --non-interactive
- ```
- The [install guide](https://iii.dev/docs/install) has all installer options.
- ## Quickstart
- In one terminal, create and start a project:
- ```bash
- iii project init my-app && cd my-app
- iii compose --up # start the engine and the project's workers; keep it running
- ```
- In a second terminal, add a worker from the registry:
- ```bash
- cd my-app
- iii call compose::add worker=http
- ```
- The engine listens on `ws://localhost:49134`. The console serves at http://127.0.0.1:3113. Continue with the [Quickstart](https://iii.dev/docs/quickstart).
- ## SDKs
- | Language | Package | Install |
- | --- | --- | --- |
- | TypeScript (Node.js) | [`iii-sdk`](https://www.npmjs.com/package/iii-sdk) | `pnpm add iii-sdk` |
- | TypeScript (browser) | [`iii-browser-sdk`](https://www.npmjs.com/package/iii-browser-sdk) | `pnpm add iii-browser-sdk` |
- | Python | [`iii-sdk`](https://pypi.org/project/iii-sdk/) | `pip install iii-sdk` |
- | Rust | [`iii-sdk`](https://crates.io/crates/iii-sdk) | `cargo add iii-sdk` |
- | Go | [`iii`](https://pkg.go.dev/github.com/iii-hq/iii/sdk/packages/go/iii) | `go get github.com/iii-hq/iii/sdk/packages/go/iii` |
- ## Repository structure
- | Path | Contents |
- | --- | --- |
- | [`engine/`](engine/README.md) | Rust engine and `iii` CLI |
- | [`sdk/`](sdk/README.md) | SDKs for TypeScript, Python, Rust, and Go |
- | [`docs/`](docs/README.md) | Documentation source for [iii.dev/docs](https://iii.dev/docs) (Mintlify) |
- | [`website/`](website/README.md) | Source for [iii.dev](https://iii.dev) |
- | [`skills/`](skills/) | Agent skills for coding agents |
- | [`tech-specs/`](tech-specs/) | Technical specifications |
- ## Contributing
- Contributions are welcome. Read [CONTRIBUTING.md](CONTRIBUTING.md) for setup, commands, and the contribution license terms.
- ```bash
- pnpm install && pnpm build # JS/TS packages
- cargo build --release # engine and Rust SDK
- pnpm test && cargo test # tests
- ```
- Report bugs and request features in [GitHub issues](https://github.com/iii-hq/iii/issues).
- ## Community
- - [Discord](https://discord.gg/iiidev): questions and discussion
- - [X](https://x.com/iiidevs) and [LinkedIn](https://www.linkedin.com/company/iii-dev): news
- - [Blog](https://iii.dev/blog): architecture posts and worked examples
- - [Roadmap](https://iii.dev/roadmap): what comes next
- ## License
- - `engine/` (engine and CLI): [Elastic License 2.0](engine/LICENSE)
- - iii Workers, docs, and SDKs: [Apache License 2.0](sdk/LICENSE)
- All contributions are made under Apache 2.0. See [CONTRIBUTING.md](CONTRIBUTING.md#license-of-contributions) for full contribution and licensing details.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.