mirror of https://github.com/Canner/WrenAI.git synced 2026-09-21 13:20:21 +08:00

Files

T

Jax LiuandClaude Opus 4.8 34305b7974 fix(core): refresh Cargo.lock for package rename

The committed wren-core-py and wren-core-wasm lockfiles still pinned the old
`wren-core` package name and the removed `petgraph-evcxr` subtree, so CI's
`--locked` builds failed. Regenerate them to reference `wren-semantic-core`
and drop the now-unused transitive deps.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-07-09 11:53:27 +08:00

.claude

chore(wren-core-py): migrate from Poetry to uv (#2363 )

2026-06-15 15:02:59 +08:00

scripts

chore: add PyPI publishing infrastructure for wren-core-py (#1496 )

2026-04-01 11:25:23 +08:00

src

fix(core-py): drop orphan cubes when their base model is pruned (#2362 )

2026-06-18 12:00:45 +08:00

tests

feat(wasm): full Cube support — validate, translate, PyO3, CLI, WASM, docs (#2282 )

2026-05-15 12:53:02 +08:00

.dockerignore

fix(ci): include README.md in wren-core-py Docker build context (#1498 )

2026-04-01 12:00:05 +08:00

AGENTS.md

docs: add per-module .claude/CLAUDE.md and redirect AGENTS.md (#1466 )

2026-03-20 10:00:03 +08:00

build.rs

chore(core): rename wren-modeling to wren-core (#848 )

2024-10-24 19:15:43 +08:00

Cargo.lock

fix(core): refresh Cargo.lock for package rename

2026-07-09 11:53:27 +08:00

Cargo.toml

chore(core): prepare Rust crates for crates.io publish

2026-07-09 11:39:11 +08:00

CHANGELOG.md

chore(main): release wren-core-py 0.7.1 (#2376 )

2026-06-22 11:06:07 +08:00

justfile

chore(wren-core-py): migrate from Poetry to uv (#2363 )

2026-06-15 15:02:59 +08:00

pyproject.toml

chore(main): release wren-core-py 0.7.1 (#2376 )

2026-06-22 11:06:07 +08:00

README.md

fix: finish wren-engine → wrenai rename cleanup (#2425 )

2026-07-03 09:55:17 +08:00

rustfmt.toml

chore(core): rename wren-modeling to wren-core (#848 )

2024-10-24 19:15:43 +08:00

uv.lock

chore(main): release wren-core-py 0.7.1 (#2376 )

2026-06-22 11:06:07 +08:00

README.md

Wren Core Python Binding

Python bindings for wren-core, the Rust semantic engine behind Wren Engine. Built with PyO3 and Maturin.

Wren Engine translates SQL queries through a semantic layer (MDL - Modeling Definition Language) and executes them against 22+ data sources (PostgreSQL, BigQuery, Snowflake, etc.).

Installation

pip install wren-core-py

Requires Python >= 3.11.

Pre-built wheels are available for:

Linux x86_64
macOS x86_64 / ARM64 (Apple Silicon)
Windows x86_64

Linux ARM64 wheels are not yet available. To use on that platform, build from source (requires Rust toolchain).

Quick Start

from wren_core import SessionContext, to_manifest

# Load an MDL manifest from a base64-encoded JSON string
base64_mdl_json = "<your-base64-encoded-mdl-json>"
manifest = to_manifest(base64_mdl_json)

# Create a session context for query planning
ctx = SessionContext(manifest, remote_functions=[])

# Transform a SQL query through the semantic layer
planned_sql = ctx.transform_sql("SELECT * FROM my_model")

Developer Guide

Environment Setup

Install Rust and Cargo
Install Python
Install uv
Install casey/just

Test and Build

After installing casey/just, you can use the following commands:

just install — Create Python venv and install dependencies.
just develop — Build the Rust package for local development (required before running Python tests).
just test-rs — Run Rust tests only.
just test-py — Run Python tests only.
just test — Run both Rust and Python tests.
just build — Build the Python wheel. Output goes to target/wheels/.

Coding Style

Format via just format.

Publishing

See scripts/publish.sh for local publishing to PyPI/TestPyPI:

./scripts/publish.sh --build    # Build wheel only
./scripts/publish.sh --test     # Build + publish to TestPyPI
./scripts/publish.sh            # Build + publish to PyPI

License

Apache-2.0