📣 2026-05-07 — Wren Engine has merged into this repo under
core/. The previousCanner/wren-enginerepo is archived. The previous WrenAI GenBI app is preserved on thelegacy/v1branch (tagv1-final). Read the announcement →
WrenAI is an open-source context layer for MCP clients and AI agents. It translates SQL queries through a semantic layer (MDL — Modeling Definition Language) and executes them against 20+ data sources (PostgreSQL, BigQuery, Snowflake, Spark, etc.). The Rust engine is powered by Apache DataFusion. Use it as a Python SDK, a CLI, a WASM module in the browser, or as building blocks for AI-agent skills.
pip install wren-engine
mkdir my-project && cd my-project
wren context init
# add a connection profile (interactive)
wren profile add my-db --interactive
# prepare your MDL project (edit wren_project.yml and add models)
wren --sql 'SELECT order_id FROM "orders" LIMIT 10'Full CLI guide: core/wren/README.md. Installable extras for each connector are listed there.
Wren Engine is built to work across modern data stacks, including warehouses, databases, and file-based sources.
Current open source support includes connectors such as:
- Amazon S3
- Apache Spark
- Apache Doris
- Athena
- BigQuery
- ClickHouse
- Databricks
- DuckDB
- Google Cloud Storage
- Local files
- MinIO
- MySQL
- Oracle
- PostgreSQL
- Redshift
- SQL Server
- Snowflake
- Trino
See the connector API docs in the project documentation for the latest connection schemas and capabilities.
| Path | What's there |
|---|---|
core/ |
Rust engine + Python/WASM bindings + CLI. The context layer's core machinery. |
core/wren-core/ |
Rust semantic engine (Cargo workspace). |
core/wren-core-base/ |
Manifest types (Model, Column, Cube, Relationship, View). |
core/wren-core-py/ |
PyO3 bindings (PyPI: wren-core). |
core/wren-core-wasm/ |
WebAssembly build for in-browser semantic SQL (npm: wren-core-wasm). |
core/wren/ |
Python SDK + wren CLI (PyPI: wren-engine). |
core/wren-mdl/ |
MDL JSON schema. |
skills/ |
CLI-based agent skills (wren-generate-mdl, wren-usage, wren-dlt-connector, wren-onboarding). |
sdks/integrations/ |
Framework integrations (LangChain, CrewAI, Pydantic-AI, Goose, LlamaIndex, Mastra) — coming soon. |
examples/ |
End-to-end example projects — coming soon. |
docs/core/ |
Module documentation. |
- Discussions: github.com/Canner/WrenAI/discussions
- Issues: github.com/Canner/WrenAI/issues
- Discord: discord.gg/canner
- Docs site: docs.getwren.ai
WrenAI is multi-licensed:
core/**,skills/**,sdks/integrations/**,examples/**, root-level files — Apache License 2.0docs/**— Creative Commons Attribution 4.0 International (CC BY 4.0)
Future modules may be introduced under GNU Affero General Public License v3.0; the full text is committed here pre-emptively. See LICENSE for the authoritative path-to-license map.
Published packages declare their effective license in their package manifest (Cargo.toml, pyproject.toml, package.json).