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: 12 days 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 (4 months ago)
- Default Branch: main
- Last Pushed: 2026-03-11T02:47:06.000Z (about 1 month ago)
- Last Synced: 2026-03-11T08:18:23.311Z (about 1 month 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
README
# Voratiq
Agent ensembles to design, generate, and select the best code for every task.
No single model wins every task. Run several, keep the best result. [Here's why that works](https://voratiq.com/blog/selection-rather-than-prediction/).
## Installation
Install via npm:
```bash
npm install -g voratiq
```
Requirements
- Node 20+
- git
- 1+ AI coding agent (Claude [>=2.1.63](https://github.com/anthropics/claude-code?tab=readme-ov-file#get-started), Codex [>=0.107.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 guidance on the platform-specific dependencies.
Windows is not currently supported.
## Quick Start
Get started with a single command:
```bash
voratiq
```
This drops you into an interactive session with an agent of your choice.
That agent gets access to Voratiq tools for orchestration and verification.
Describe what you want built, and the agent can use those tools to:
- turn your request into a structured execution plan
- delegate work to a custom-designed swarm or a multi-stage workflow
- verify outputs and compare alternatives before choosing what to keep
- track outcomes across runs to learn which agents and workflows work best
You keep the native interactive workflow, with more execution depth and control.
## Documentation
Start here:
- [Tutorial](https://github.com/voratiq/voratiq/blob/main/docs/tutorial.md) - End-to-end walkthrough
- [CLI Reference](https://github.com/voratiq/voratiq/blob/main/docs/cli-reference.md) - Commands and options
- [Core Concepts](https://github.com/voratiq/voratiq/blob/main/docs/core-concepts.md) - Workflow model and design rationale
Configuration:
- [Agents](https://github.com/voratiq/voratiq/blob/main/docs/configs/agents.md) - Agent catalog and invocation details
- [Orchestration](https://github.com/voratiq/voratiq/blob/main/docs/configs/orchestration.md) - Which agents run at each stage
- [Verification](https://github.com/voratiq/voratiq/blob/main/docs/configs/verification.md) - How agent outputs are checked and scored before selection
- [Environment](https://github.com/voratiq/voratiq/blob/main/docs/configs/environment.md) - Runtime dependencies for agents
- [Sandbox](https://github.com/voratiq/voratiq/blob/main/docs/configs/sandbox.md) - Network and filesystem restrictions
## License
Voratiq is available under the [MIT License](https://github.com/voratiq/voratiq/blob/main/LICENSE).