Skip to content
Back to search

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.

Checked today

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/iii-hq-iii/badge.svg)](/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

i

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.

  1. <div align="center">
  2. # iii
  3. **More application. Less infrastructure.**
  4. Connect any functions, agents, APIs, models, browsers, infrastructure, and machines into one live, composable system.
  5. [![GitHub stars](https://img.shields.io/github/stars/iii-hq/iii?style=flat&logo=github)](https://github.com/iii-hq/iii/stargazers)
  6. [![CI](https://img.shields.io/github/actions/workflow/status/iii-hq/iii/ci.yml?branch=main&label=CI&logo=githubactions&logoColor=white)](https://github.com/iii-hq/iii/actions/workflows/ci.yml)
  7. [![Release](https://img.shields.io/github/v/release/iii-hq/iii?label=release)](https://github.com/iii-hq/iii/releases)
  8. [![Contributors](https://img.shields.io/github/contributors/iii-hq/iii)](https://github.com/iii-hq/iii/graphs/contributors)
  9. [![License](https://img.shields.io/badge/license-Apache--2.0%20%2B%20ELv2-blue)](#license)
  10. [![npm](https://img.shields.io/npm/v/iii-sdk?label=npm&logo=npm)](https://www.npmjs.com/package/iii-sdk)
  11. [![npm downloads](https://img.shields.io/npm/dw/iii-sdk?label=npm%20downloads)](https://www.npmjs.com/package/iii-sdk)
  12. [![PyPI](https://img.shields.io/pypi/v/iii-sdk?label=PyPI&logo=pypi&logoColor=white)](https://pypi.org/project/iii-sdk/)
  13. [![PyPI downloads](https://img.shields.io/pypi/dm/iii-sdk?label=PyPI%20downloads)](https://pypistats.org/packages/iii-sdk)
  14. [![crates.io](https://img.shields.io/crates/v/iii-sdk?logo=rust)](https://crates.io/crates/iii-sdk)
  15. [![docs.rs](https://img.shields.io/docsrs/iii-sdk?logo=docsdotrs)](https://docs.rs/iii-sdk)
  16. [![Go Reference](https://pkg.go.dev/badge/github.com/iii-hq/iii/sdk/packages/go/iii.svg)](https://pkg.go.dev/github.com/iii-hq/iii/sdk/packages/go/iii)
  17. [![Docker pulls](https://img.shields.io/docker/pulls/iiidev/iii?logo=docker&logoColor=white)](https://hub.docker.com/r/iiidev/iii)
  18. [![Discord](https://img.shields.io/discord/1322278831184281721?label=Discord&logo=discord&logoColor=white)](https://discord.gg/iiidev)
  19. [![X](https://img.shields.io/twitter/follow/iiidevs?style=flat&logo=x)](https://x.com/iiidevs)
  20. [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)
  21. English | [简体中文](README_zh.md)
  22. </div>
  23. ## Why iii
  24. 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.
  25. It's estimated that up to 70% of development time is dedicated to integrations. 40% is the lowest estimate we could find.
  26. 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.
  27. 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).
  28. ## One primitive: the Function
  29. iii organizes software around one primitive, the **Function**, and two operators:
  30. - `worker.call(a)` runs function `a` now.
  31. - `worker.observe(a, b)` makes function `b` run when function `a` runs.
  32. 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`.
  33. ```typescript
  34. import { registerWorker } from 'iii-sdk'
  35. const worker = registerWorker('ws://localhost:49134')
  36. worker.registerFunction('orders::create', async (order: { item: string; total: number }) => {
  37. return { id: crypto.randomUUID(), ...order }
  38. })
  39. worker.registerFunction('alerts::big-order', async ({ input }: { input: { total: number } }) => {
  40. console.log(`Big order: ${input.total}`)
  41. })
  42. // When orders::create runs with a total of 500 or more, alerts::big-order runs
  43. const observer = worker.observe(
  44. { function_id: 'orders::create', filters: { 'input.total': { $gte: 500 } } },
  45. 'alerts::big-order',
  46. )
  47. await observer.ready()
  48. // Run orders::create now and wait for its result
  49. const order = await worker.call({ function_id: 'orders::create', payload: { item: 'widget', total: 750 } })
  50. console.log(order)
  51. ```
  52. The same API is in every SDK. See [sdk/README.md](sdk/README.md).
  53. ## Built for C.O.D.E.R.
  54. | | Property | What you get |
  55. | --- | --- | --- |
  56. | **C** | Composability | Functions in different languages and locations work together seamlessly. |
  57. | **O** | Observability | One trace follows every execution step across languages and machines. Export over OTLP. |
  58. | **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. |
  59. | **E** | Extensibility | Workers can be added and removed at any time with a single command. |
  60. | **R** | Reactivity | Anything can be an observer or observed. Reactivity and events do not need to be pre-planned. |
  61. ## Install
  62. ```bash
  63. curl -fsSL https://iii.dev/registry/install/iii/latest.sh | sh
  64. ```
  65. On Windows, in PowerShell:
  66. ```powershell
  67. irm https://iii.dev/registry/install/iii/latest.ps1 | iex
  68. ```
  69. The installer asks to set up your first project. Press Enter, then open http://127.0.0.1:3113.
  70. For CI, Docker builds, and scripts, install without the prompt:
  71. ```bash
  72. curl -fsSL https://iii.dev/registry/install/iii/latest.sh | sh -s -- --non-interactive
  73. ```
  74. The [install guide](https://iii.dev/docs/install) has all installer options.
  75. ## Quickstart
  76. In one terminal, create and start a project:
  77. ```bash
  78. iii project init my-app && cd my-app
  79. iii compose --up # start the engine and the project's workers; keep it running
  80. ```
  81. In a second terminal, add a worker from the registry:
  82. ```bash
  83. cd my-app
  84. iii call compose::add worker=http
  85. ```
  86. 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).
  87. ## SDKs
  88. | Language | Package | Install |
  89. | --- | --- | --- |
  90. | TypeScript (Node.js) | [`iii-sdk`](https://www.npmjs.com/package/iii-sdk) | `pnpm add iii-sdk` |
  91. | TypeScript (browser) | [`iii-browser-sdk`](https://www.npmjs.com/package/iii-browser-sdk) | `pnpm add iii-browser-sdk` |
  92. | Python | [`iii-sdk`](https://pypi.org/project/iii-sdk/) | `pip install iii-sdk` |
  93. | Rust | [`iii-sdk`](https://crates.io/crates/iii-sdk) | `cargo add iii-sdk` |
  94. | 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` |
  95. ## Repository structure
  96. | Path | Contents |
  97. | --- | --- |
  98. | [`engine/`](engine/README.md) | Rust engine and `iii` CLI |
  99. | [`sdk/`](sdk/README.md) | SDKs for TypeScript, Python, Rust, and Go |
  100. | [`docs/`](docs/README.md) | Documentation source for [iii.dev/docs](https://iii.dev/docs) (Mintlify) |
  101. | [`website/`](website/README.md) | Source for [iii.dev](https://iii.dev) |
  102. | [`skills/`](skills/) | Agent skills for coding agents |
  103. | [`tech-specs/`](tech-specs/) | Technical specifications |
  104. ## Contributing
  105. Contributions are welcome. Read [CONTRIBUTING.md](CONTRIBUTING.md) for setup, commands, and the contribution license terms.
  106. ```bash
  107. pnpm install && pnpm build # JS/TS packages
  108. cargo build --release # engine and Rust SDK
  109. pnpm test && cargo test # tests
  110. ```
  111. Report bugs and request features in [GitHub issues](https://github.com/iii-hq/iii/issues).
  112. ## Community
  113. - [Discord](https://discord.gg/iiidev): questions and discussion
  114. - [X](https://x.com/iiidevs) and [LinkedIn](https://www.linkedin.com/company/iii-dev): news
  115. - [Blog](https://iii.dev/blog): architecture posts and worked examples
  116. - [Roadmap](https://iii.dev/roadmap): what comes next
  117. ## License
  118. - `engine/` (engine and CLI): [Elastic License 2.0](engine/LICENSE)
  119. - iii Workers, docs, and SDKs: [Apache License 2.0](sdk/LICENSE)
  120. 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 in

Free to use. If it’s helped, pass it on.