README.md

---
title: Flow
emoji: 🌊
colorFrom: blue
colorTo: purple
sdk: docker
app_port: 7860
pinned: false
---

# Flow

Flow helps you find the best configuration for your AI coding agent. Define your agent spec, provide evaluation tasks, and Flow automatically generates variants, scores them, and shows you the quality vs. cost tradeoffs.

- **Simplified experimentation** — Automates the search for optimal agent configurations
- **Transparency** — See exactly what was tested, scores, and tradeoffs on a Pareto chart
- **User control** — Choose your tasks, evaluation criteria, and approve variants
- **Framework agnostic** — Standardized agent spec with pluggable runtime adapters

## Usage

1. Create or import an agent configuration
2. Define evaluation tasks with criteria
3. Run optimization to generate and test variants
4. View results on the Pareto chart (quality vs. cost)

## Links

- **GitHub**: [victordibia/flow](https://github.com/victordibia/flow)
- **Documentation**: See GitHub README for full documentation