# Agent workflows that stay reliable. Free, self-hosted, Apache-2.0. One-shot agent workflows with an MCP toolkit — pip install readyagentsdev, or clone; bring your own keys. ReadyAgents is a free, self-hosted Apache-2.0 local one-shot agent workflow engine plus MCP toolkit: pip install readyagentsdev, bring your own keys; always-on packs are waitlisted and not for sale. - [Install from PyPI](https://pypi.org/project/readyagentsdev/) - [Join the waitlist](/waitlist) - [View on GitHub →](https://github.com/readyagentsdev/readyagents-core) - Free local core - BYOK ## First run No keys for that run. ``` pip install readyagentsdev readyagents new f --from-example calc_pipeline readyagents run f/workflow.yaml ``` Current **2.0.12**. Or clone https://github.com/readyagentsdev/readyagents-core, `pip install -e .`, then `readyagents run examples/calc_pipeline.yaml`. [Release notes](https://github.com/readyagentsdev/readyagents-core/releases/tag/v2.0.12). Packs waitlisted, not for sale. ## What is ReadyAgents? ReadyAgents is an open-core product. The core Agent Workflow and MCP Toolkit is free and open source. The core is the free local toolkit. ### Open-source core Agent Workflow + MCP Toolkit on GitHub. Inspect it, fork it, run it with your own keys. ### Bring your own keys Bring your own keys. You keep the provider account and the bill. ## What is in core through 2.0.12 Short facts for humans and agents. Local, BYOK, no hosted control plane. Packs stay waitlisted and not for sale. ### Local YAML/JSON workflows One-shot local runs from YAML or JSON. Bring your own provider keys. Persist and resume after each node. ### MCP toolkit (stdio) `readyagents mcp serve` defaults to stdio so existing MCP hosts keep working unchanged. ### Streamable HTTP + tasks Opt-in loopback Streamable HTTP with MCP 2026-07-28 task handles (start/poll/decide/cancel). No hosted recovery. ### Browser approval / HITL Localhost approval UI and signed decisions for human-in-the-loop gates — same audit path as the CLI. Exit **2** means a human gate is waiting, not that it crashed. ### SQLite migrate path Readable JSON run records by default; `readyagents runs migrate` copies into an opt-in local SQLite store. ### Sandboxed builtins Workspace-bound tools such as `calc`, file read/write, and `list_dir`. No pack marketplace and no always-on hosted agents in core. ### Typed decisions (experimental) `type: decide` asks typed questions and routes on confidence; below `min_confidence` it stops at a human gate. Keyless `shim` keeps the file runnable; it is not `jev` and has no calibrated confidence. Not a general LLM node. ### Spend ledger + caps Per-node tokens and cost in a local ledger; `--estimate` before running, `--max-spend` / `--max-tokens` to stop a run. `readyagents spend` aggregates. Informational — the provider invoice is the truth. ## How it works ### 01. Start with the open toolkit Current 2.0.12: `pip install readyagentsdev`, then `readyagents new f --from-example calc_pipeline` and `readyagents run f/workflow.yaml`. No keys for that run. Or clone [github.com/readyagentsdev/readyagents-core](https://github.com/readyagentsdev/readyagents-core) and run examples/calc_pipeline.yaml. ### 02. Compose a reliable workflow Write a YAML (or JSON) workflow. HITL is [`docs/first-ten-minutes.md`](https://github.com/readyagentsdev/readyagents-core/blob/main/docs/first-ten-minutes.md). ### 03. If you need always-on later If you need always-on later, join the waitlist. ## Want always-on agents? Join the waitlist. Packs are not for sale yet. The free core stays a local one-shot. [Join the waitlist](/waitlist) ## Get started The open-source toolkit is the starting point. Packs are not for sale. - [Read the getting started guide](/docs) - [GitHub](https://github.com/readyagentsdev/readyagents-core) 1. **Install from PyPI** — pip install readyagentsdev (Current 2.0.12, Python 3.11–3.14) 1. **Materialize the keyless example** — readyagents new f --from-example calc_pipeline 1. **Run it** — readyagents run f/workflow.yaml — no API keys needed. 1. **Or clone instead** — git clone https://github.com/readyagentsdev/readyagents-core.git && cd readyagents-core && python -m venv .venv && source .venv/bin/activate && pip install -e . && readyagents run examples/calc_pipeline.yaml 1. **Add keys only if you want LLM examples** — Copy .env.example to .env and set your own provider key. The first run above works without this. Tried it? Open an [I-ran-this issue](https://github.com/readyagentsdev/readyagents-core/issues/new?template=i-ran-this.md). We are not launching. ## Join the waitlist for always-on packs Packs are not for sale yet. Open Core stays a free local one-shot, BYOK. One email when that changes. - One email when packs exist - Open Core stays free, local, BYOK POST `/waitlist` with `email` (required work email), optional `name`, and `interest` (`toolkit` | `premium` | `both`).