Metadata-Version: 2.4
Name: aqven
Version: 0.0.4
Summary: Engineering layer for reliable AI workflows: files as the source of truth, a compiler, a checkpointed runtime and a local Studio.
Keywords: ai,llm,workflow,agents,evaluation,pydantic-ai
Author: Kirill Burkhanov
License-Expression: LicenseRef-AQVEN-1.0.0
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Dist: aqven-llm==0.0.4
Requires-Dist: pydantic==2.13.5
Requires-Dist: ruamel-yaml==0.19.1
Requires-Dist: python-liquid==2.3.1
Requires-Dist: httpx2==2.13.0
Requires-Dist: pydantic-ai-slim[mcp]==2.43.0
Requires-Dist: pydantic-evals==2.43.0
Requires-Dist: dbos==2.31.1
Requires-Dist: fastapi==0.141.1
Requires-Dist: uvicorn==0.53.0
Requires-Dist: python-multipart==0.0.32
Requires-Dist: mcp==2.2.0
Requires-Dist: rfc8785==0.1.4
Requires-Dist: watchfiles==1.2.0
Requires-Dist: genai-prices==0.1.7
Requires-Dist: scipy==1.18.1
Requires-Dist: numpy==2.5.3
Requires-Dist: opentelemetry-sdk==1.44.0
Requires-Dist: opentelemetry-exporter-otlp-proto-http==1.44.0
Requires-Dist: claude-agent-sdk==0.2.154
Requires-Dist: openai-codex==0.147.0
Requires-Dist: httpx==0.28.1
Requires-Dist: tenacity==9.1.4
Requires-Dist: python-dotenv==1.2.3
Requires-Dist: aqven-llm[anthropic]==0.0.4 ; extra == 'anthropic'
Requires-Dist: aqven-llm[bedrock]==0.0.4 ; extra == 'bedrock'
Requires-Dist: aqven-llm[cohere]==0.0.4 ; extra == 'cohere'
Requires-Dist: aqven-llm[google]==0.0.4 ; extra == 'google'
Requires-Dist: aqven-llm[groq]==0.0.4 ; extra == 'groq'
Requires-Dist: aqven-llm[huggingface]==0.0.4 ; extra == 'huggingface'
Requires-Dist: aqven-llm[mistral]==0.0.4 ; extra == 'mistral'
Requires-Dist: aqven-llm[xai]==0.0.4 ; extra == 'xai'
Requires-Python: >=3.14, <3.15
Project-URL: Homepage, https://aqvenstudio.com
Project-URL: Documentation, https://aqvenstudio.com
Project-URL: Repository, https://github.com/lastonoga/AQVEN
Project-URL: Issues, https://github.com/lastonoga/AQVEN/issues
Provides-Extra: anthropic
Provides-Extra: bedrock
Provides-Extra: cohere
Provides-Extra: google
Provides-Extra: groq
Provides-Extra: huggingface
Provides-Extra: mistral
Provides-Extra: xai
Description-Content-Type: text/markdown

# AQVEN

**Discover what your AI workflow needs to work reliably.** A Python framework and a local Studio for AI
workflows. Your coding agent runs the experiments. You see the evidence and decide.

**[Documentation](https://aqvenstudio.com)** · **[Quickstart](https://aqvenstudio.com/start/quickstart/)** · **[Use cases](https://aqvenstudio.com/use-cases/)** · **[Studio](https://aqvenstudio.com/studio/)** · **[GitHub](https://github.com/lastonoga/AQVEN)**

![AQVEN Studio showing a multi-step AI workflow on one canvas](https://raw.githubusercontent.com/lastonoga/AQVEN/main/apps/site/public/images/studio/canvas.png)

AQVEN keeps an AI workflow as typed files in your repository: a flow, one file per step, prompts in
Markdown, and declared types, agents and tools. `aqven check` validates every connection and simulates
every flow before you spend a token. Studio, a local browser app in the same install, shows each run
step by step. Your coding agent works on the same files through AQVEN's MCP server, and runs experiments
whose verdicts AQVEN computes.

AQVEN is in alpha: expect changes between releases.

## What it's for

- **Find.** *"What am I missing?"* Your agent explores cases and variants you wouldn't try yourself.
- **Explain.** *"Why did this fail?"* Follow a bad answer back to the step where it started.
- **Compare.** *"What should I change?"* Models and prompts side by side, with cost and latency.
- **Confirm.** *"Can I trust this change?"* A verdict on held-out cases that is allowed to say inconclusive.
- **Build.** *"How do I keep it readable as it grows?"* Typed files in your repo, checked before a run costs a token.

## Install

You need [uv](https://docs.astral.sh/uv/getting-started/installation/). AQVEN runs on Python 3.14, and uv
fetches it for you. Studio ships inside the package: no Node.js toolchain, nothing to build.

```bash
uv tool install aqven
aqven new my_project --template minimal --provider openrouter
cd my_project
uv run aqven check my_project
```

```text
errors: 0, warnings: 0
```

`aqven new` writes the project, installs its environment and generates typed Python models. It also
prepares the project for a coding agent: `AGENTS.md`, `CLAUDE.md`, an `.mcp.json` that registers AQVEN's
MCP server, and Claude Code hooks that run `aqven check` as the agent works. `aqven check` needs no API key
and no network.

## Work with your coding agent

Start Claude Code in the project, approve the `aqven` server, and hand it a task. It builds the flow,
explores on working cases and confirms once on held-out cases; you read the first traces and make the
decisions. Open Studio next to it with `uv run aqven dev my_project`.

For Codex, Cursor or another MCP client, see
[How to set up a coding agent outside Studio](https://aqvenstudio.com/mcp-cli/set-up-an-agent-outside-studio/).

## Commands

| Command | What it does |
| --- | --- |
| `aqven new` | creates a project from a template, installs its environment and generates its models |
| `aqven check` | checks the project and simulates every flow without network or tokens |
| `aqven run` | runs a flow locally and prints run events as they happen |
| `aqven dev` | starts the project server and opens Studio in the browser |
| `aqven serve` | the project server without a browser: Studio API, engine and MCP |
| `aqven mcp` | MCP over stdio, for a coding agent outside Studio |

## Built on

[Pydantic AI](https://ai.pydantic.dev/) calls the models, [DBOS](https://www.dbos.dev/) checkpoints every
run on SQLite, the official [MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk) serves and
consumes MCP, and [FastAPI](https://fastapi.tiangolo.com/) serves Studio and the API. Runs locally.

## License

AQVEN is source-available, not open source, under the AQVEN License 1.0.0, based on
[PolyForm Shield 1.0.0](https://polyformproject.org/licenses/shield/1.0.0). Use it for any purpose,
including in production and in commercial products you build with it. You may not use it to provide a
product that competes with AQVEN, and you may redistribute AQVEN itself only free of charge and for a
non-commercial purpose. Full terms: [LICENSE](https://github.com/lastonoga/AQVEN/blob/main/LICENSE).

Copyright Kirill Burkhanov.
