Repolode
Canner

Canner/WrenAI

Open-source GenBI engine that lets AI agents turn natural-language questions into governed SQL and shareable dashboards over 20+ data sources.

Open-source alternative to:TableauPower BIThoughtSpot

Stars
17,928
Forks
2,063
Open issues
262
Last commit
10 hours ago

What is it?

WrenAI is a generative BI engine built for AI agents. It sits between an agent and your data warehouse, providing a semantic layer (MDL) that defines metrics, relationships, enums, units and approved joins, so agents generate SQL against business meaning rather than raw schemas alone.

The project covers the loop from question to answer: it generates governed SQL with dry-plan validation and row limits, and can deploy an agent-built dashboard as a browser-side app to Vercel or Cloudflare Pages. Business context such as metric definitions and example queries is stored as YAML and Markdown files in a Git repository.

It works with Claude Code, Cursor, Cline, Codex, MCP clients and LangChain, and connects to BigQuery, Snowflake, PostgreSQL, ClickHouse, Amazon Redshift, Databricks, DuckDB and more. The core engine is Apache-2.0 licensed, while dashboard UI, row-level security and some agent harnesses are offered as commercial add-ons.

Key features

  • 01Generates SQL from natural-language questions using a semantic layer (MDL).
  • 02Validates queries with dry-plan checks, row limits and structured error messages.
  • 03Deploys agent-built dashboards as browser-side apps to Vercel or Cloudflare Pages.
  • 04Stores metric definitions, enums and example queries as version-controlled YAML and Markdown.
  • 05Provides a CLI and SDKs for LangChain, LangGraph and Pydantic AI.
  • 06Connects to 20+ data sources on an Apache DataFusion engine.

Use cases

  • Letting an AI agent answer business questions against a data warehouse with governed SQL.
  • Turning an agent-generated analysis into a shareable, filterable dashboard.
  • Keeping metric definitions in Git so teams can review changes in pull requests.
  • Adding a governed text-to-SQL layer to an existing LangChain or MCP-based agent.

Quick start

  1. 1

    Install the CLI from PyPI

    pip install wrenai
  2. 2

    Install the agent skill discovery stub

    npx skills add Canner/WrenAI
  3. 3

    Open your agent in a project folder and ask it to set up your database with Wren

Things to know

  • License is listed as NOASSERTION in metadata, though the README states the engine is Apache-2.0.
  • Some features such as row- and column-level security, GenBI UI and dashboards are commercial and not in the open-source engine.
  • Setup depends on an AI agent and a database connection, so it is not a standalone point-and-click tool.

Topics

FAQ

What is WrenAI?
Open-source GenBI engine that lets AI agents turn natural-language questions into governed SQL and shareable dashboards over 20+ data sources. WrenAI is a generative BI engine built for AI agents. It sits between an agent and your data warehouse, providing a semantic layer (MDL) that defines metrics, relationships, enums, units and approved joins, so agents generate SQL against business meaning rather than raw schemas alone.
Is WrenAI free to use? What license does it have?
WrenAI is open source under the Other license. Check the license terms before using it in commercial products.
Is WrenAI still maintained?
Actively maintained. The last commit to WrenAI was on Oct 21, 2026.
What can I use WrenAI for?
Letting an AI agent answer business questions against a data warehouse with governed SQL. Turning an agent-generated analysis into a shareable, filterable dashboard. Keeping metric definitions in Git so teams can review changes in pull requests. Adding a governed text-to-SQL layer to an existing LangChain or MCP-based agent.
How do I install WrenAI?
Install the CLI from PyPI: pip install wrenai Install the agent skill discovery stub: npx skills add Canner/WrenAI Open your agent in a project folder and ask it to set up your database with Wren
Where can I get WrenAI?
The source code and installation instructions are on GitHub: https://github.com/Canner/WrenAI

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects