Skip to main content

Valved

CI PyPI Python License: Apache 2.0

Agent-native data engineering, from natural language to production pipelines.

Valved takes a goal in plain English — "make stg_orders incremental", "ingest the Stripe charges API into a Snowflake table" — turns it into a reviewable plan, and, when you approve, materializes the working code and opens a pull request in your repo: dbt models, Python dlt sources, SQL, tests, schema docs. All the boring parts of building and maintaining a warehouse pipeline, executed by agents that read your conventions and respect your existing project. It's an AI-first, open-source control plane over dlt + dbt — self-hosted, Apache 2.0.

Status: v0.1.0 — the first release. The full loop (init → plan → build → run → deploy → schedule) is built and green across 3,000+ tests, with CLI / REST / MCP parity. Pre-1.0: it's usable and complete, with room to refine the API before committing to 1.0 stability.

Install

pip install valved

Requires Python 3.11+. Valved runs against your own Postgres (a bundled docker compose is scaffolded for you) and your own warehouse (Snowflake is first-class).

Quickstart

valved init --with-dbt              # scaffold a dlt + dbt project (+ bundled Postgres)
docker compose up -d                # start the state store
cp .env.example .env                # add ANTHROPIC_API_KEY + your Snowflake target

# intent → reviewable plan → working code
valved plan "ingest the Stripe charges API into raw_stripe, then a staging model stg_charges"
valved build <plan_id>              # writes the dlt source, the dbt model, and pipelines/<name>.toml
valved run <pipeline> --watch       # execute on demand; data lands in your warehouse
valved deploy <pipeline>            # open a reviewable PR with the built code (default handoff)

valved auto-loads a project-local .env on startup (existing shell vars win). Set VALVED_NO_DOTENV=1 to disable it if you manage env vars elsewhere (direnv, mise, 1Password CLI).

What it does

The core loop — every step is a valved verb, with a REST + MCP equivalent:

  • plan → build — an AI harness turns intent into a reviewable Plan, then materializes it (dlt sources, dbt models, pipeline composition). It verifies by executing, not guessing. plan-and-build is the one-shot path.
  • run / serve / worker — on-demand and scheduled execution over a durable job queue + worker pool (cron scheduler, crash-recovery reaper, graceful drain).
  • deploy — promote built code to version control via a configurable handoff (files → commit → push → pr, default PR), including cross-repo linked PRs. Valved opens and orders the PRs; you merge.
  • ask — a read-only investigative explorer: "where does net_revenue come from?", "what breaks if I change raw_stripe.charges?" — answered with citations by investigating dbt's manifest + dlt's schema + your code.
  • Recovery — when a scheduled run fails, Valved diagnoses it (grounded in dlt's real exceptions) and proposes a reviewable fix — it never writes to prod autonomously.

Surfaces — the same functionality, four ways:

  • CLI — the full valved command set (reference).
  • REST API — FastAPI with full CLI parity, auth, streaming, webhooks (/api/openapi.json).
  • MCP server — auto-generated from REST; drive Valved from Claude Desktop / Cursor / Claude Code (valved mcp-serve).
  • Static HTML UI — run history + per-run logs (valved docs serve).

Documentation

Open source & governance

Valved is Apache 2.0 and feature-complete for single-team self-hosters — no API endpoints or MCP tools are gated behind any commercial offering. See OSS_COMMITMENT.md for what's permanently open, and governance for the model.

Contributing

Contributions welcome — DCO sign-off (git commit -s), dev setup, and PR expectations are in CONTRIBUTING.md. Report security issues privately (see SECURITY.md).

License

Apache 2.0. See LICENSE.

Metadata

Release files for valved 0.9.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for valved 0.9.0
File Size Uploaded Provenance Actions
valved-0.9.0.tar.gz 2.2 MB With provenance Details for valved-0.9.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for valved 0.9.0
File Interpreter ABI Platform Actions
valved-0.9.0-py3-none-any.whl Python 3 none any Details for valved-0.9.0-py3-none-any.whl

Total release size: 3.5 MB

Release files / valved-0.9.0.tar.gz

Download URL valved-0.9.0.tar.gz
Size 2.2 MB
Tags Source
SHA-256 checksum
How to use checksums
cfa551a7f4636cf753956c69c27df63fccafdd28262d65675472ce93e50b5d34
BLAKE2b-256 checksum
How to use checksums
34d67cc38bb94bff97ac90ef129d42fc4962f87703564b35585b14b30bb7f30c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / valved-0.9.0-py3-none-any.whl

Download URL valved-0.9.0-py3-none-any.whl
Size 1.3 MB
Tags Python 3
SHA-256 checksum
How to use checksums
c7185f59ee78896feae883eb3450a5567694f33d29bd6302eae37fedd5df7f07
BLAKE2b-256 checksum
How to use checksums
fbaef6f5fdf8858ca474a2aefbec74f6e40ebbc2924c39bedda7a50128f97fb0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Security for valved 0.9.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for valved-0.9.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page