WrenAI — Open Context Layer for AI Agents

📣 2026-05-07 — Wren Engine has merged into this repo under core/. The previous Canner/wren-engine repo is archived. The previous WrenAI GenBI app is preserved on the legacy/v1 branch (tag v1-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.

Quick start

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.

Supported Data Sources

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.

Repository map

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.

Community

• Discussions: github.com/Canner/WrenAI/discussions
• Issues: github.com/Canner/WrenAI/issues
• Discord: discord.gg/canner
• Docs site: docs.getwren.ai

License

WrenAI is multi-licensed:

• core/**, skills/**, sdks/integrations/**, examples/**, root-level files — Apache License 2.0
• docs/** — 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).

Our Contributors

⬆️ Back to Top