https://github.com/voratiq/voratiq
Agent ensembles to design, generate, and select the best code for every task.
https://github.com/voratiq/voratiq
agents ai cli code-generation evals multi-agent orchestration-framework sandboxing spec-driven-development
Last synced: about 1 month ago
JSON representation
Agent ensembles to design, generate, and select the best code for every task.
- Host: GitHub
- URL: https://github.com/voratiq/voratiq
- Owner: voratiq
- License: mit
- Created: 2025-12-10T13:44:07.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-03-11T02:47:06.000Z (3 months ago)
- Last Synced: 2026-03-11T08:18:23.311Z (3 months ago)
- Topics: agents, ai, cli, code-generation, evals, multi-agent, orchestration-framework, sandboxing, spec-driven-development
- Language: TypeScript
- Homepage: https://voratiq.com
- Size: 1.85 MB
- Stars: 59
- Watchers: 4
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ai-sandbox - voratiq - Agent-ensemble coding system; sandboxing is secondary to orchestration. (Adjacent agent systems and specialized experiments / Multiplatform)
README
# Voratiq
Run workflows, delegate to swarms, and verify outputs before you apply them.
Voratiq provides composable operators for structured multi-agent workflows, with durable artifacts and session history that keep each step inspectable as work unfolds.
## Installation
```bash
npm install -g voratiq
```
Requirements
- Node 20+
- git
- 1+ AI coding agent (Claude [>=2.1.111](https://github.com/anthropics/claude-code?tab=readme-ov-file#get-started), Codex [>=0.122.0](https://github.com/openai/codex?tab=readme-ov-file#quickstart), or Gemini [>=0.31.0](https://github.com/google-gemini/gemini-cli?tab=readme-ov-file#quick-install))
- macOS: `ripgrep`
- Linux (Debian/Ubuntu): `bubblewrap`, `socat`, `ripgrep`
See the [sandbox runtime docs](https://github.com/anthropic-experimental/sandbox-runtime/blob/1bafa66a2c3ebc52569fc0c1a868e85e778f66a0/README.md#platform-specific-dependencies) for platform-specific dependencies.
Windows is not currently supported.
## Quick Start
From a git repo root, run:
```bash
voratiq
```
That opens an interactive agent session with access to Voratiq's operators.
From there, the agent can:
- run multi-step workflows with explicit stages
- delegate work to swarms of agents
- verify outputs before applying them
- use different workflow architectures for different tasks
- inspect session history and artifacts
For more information, see the [getting started](https://github.com/voratiq/voratiq/blob/main/docs/getting-started.md) guide.
## Documentation
Start here:
- [Getting Started](https://github.com/voratiq/voratiq/blob/main/docs/getting-started.md) - Which workflow to use and how to run it
- [How It Works](https://github.com/voratiq/voratiq/blob/main/docs/how-it-works.md) - Operators, verification, and artifacts
- [CLI Reference](https://github.com/voratiq/voratiq/blob/main/docs/cli-reference.md) - Commands and options
- [Troubleshooting](https://github.com/voratiq/voratiq/blob/main/docs/troubleshooting.md) - Common setup and runtime issues
Configuration:
- [Agents](https://github.com/voratiq/voratiq/blob/main/docs/configs/agents.md) - Agent catalog and invocation details
- [Environment](https://github.com/voratiq/voratiq/blob/main/docs/configs/environment.md) - Runtime dependencies for agent execution
- [Sandbox](https://github.com/voratiq/voratiq/blob/main/docs/configs/sandbox.md) - Network and filesystem restrictions
- [Orchestration](https://github.com/voratiq/voratiq/blob/main/docs/configs/orchestration.md) - Which agents participate at each workflow stage
- [Verification](https://github.com/voratiq/voratiq/blob/main/docs/configs/verification.md) - How verification is configured across stages
## License
Voratiq is available under the [MIT License](https://github.com/voratiq/voratiq/blob/main/LICENSE).