Skip to main content

Python Rules Engine

Business logic humans can read and machines can run. One copy of your rules: the owner reads it, every system runs it.

License: MIT PyPI

GoRules ZEN Engine

ZEN Engine is a cross-platform, open-source Business Rules Engine (BRE) written in Rust with native Python bindings, alongside Node.js, Go, Java, Kotlin and .NET. Decisions evaluate in microseconds, run identically on every platform, and are stored as portable JSON. Loading the JSON is up to you: file system, database or service call.

Try it in the free Online Editor with a built-in simulator, or embed the open-source React JDM Editor in your own product. Learn more about the Python rules engine on the GoRules website.

Rules that read like sentences

Conditions are written the way the business says them, in the ZEN Expression Language. The developer view is one toggle away, and the two can never drift apart: there is only one source of truth, and this engine runs it.

Readable rules

Rules as graphs, or as documents

Model a decision on a visual canvas of decision tables, switches, expressions, functions and reusable sub-decisions. Or write it as a policy document with prose, typed data models and tables. Both compile to the same engine and return the same answers.

Graphs and documents

To go deeper, see the Python SDK documentation, the decision graph guide and the ZEN Expression Language reference.

What's new in 2.0

Version 2.0 is the first stable release of the new engine line:

  • Policy documents: model decisions as readable documents with typed data models, expressions, decision tables, match blocks and assertions. Policies compile to the same engine as graphs and return the same answers.
  • Workspace analysis: static type checking across policies and graphs. Type flow, exhaustiveness checking, write-conflict detection and precise diagnostics, all available before anything runs.
  • Per-column collect: decision table output columns can collect across all matching rows (tags[]) while the rest of the table stays first-match.
  • Pre-compiled engine: decisions are parsed and compiled once at load; evaluation is allocation-light and repeat-safe.
  • Hardened runtime: out-of-range numbers, arithmetic overflow and malformed inputs return errors or nulls instead of crashing the process.
  • Unified bindings: configurable loaders, batch evaluation and consistent error envelopes across Node.js, Python, Go and FFI consumers.

Installation

pip install zen-engine

Prebuilt wheels ship for Linux, macOS and Windows; no Rust toolchain required.

Quickstart

import zen

with open("./jdm_graph.json", "r") as f:
    content = f.read()

engine = zen.ZenEngine()

decision = engine.create_decision(content)
result = decision.evaluate({"input": 15})
print(result)

Loaders

For more advanced use cases where you want to load multiple decisions and reuse them across evaluations you can build loaders. When engine.evaluate is invoked it calls the loader with a key, expecting the content of the JDM decision graph in return.

import zen

def loader(key):
    with open("./jdm_directory/" + key, "r") as f:
        return f.read()

engine = zen.ZenEngine({"loader": loader})
result = engine.evaluate("jdm_graph1.json", {"input": 5})
print(result)

The same pattern works for loading from a REST API, S3, a database, or anywhere else. Full guides, including multi-decision graphs and batch evaluation, are in the Python SDK documentation.

Other platforms

The GoRules platform

The engine is open at the core; GoRules is the platform around it. Managed cloud, self-hosted, or embedded with no network hop. SOC 2 Type II.

AI that builds rules, and stays reviewable

An AI copilot and MCP server that edits rules, runs tests and explains decisions. It never deploys. Releases stay with your reviewers.

GoRules AI

Promote like a release, run like a binary

A release moves from testing to staging to production untouched. Approvals, instant rollback, and a paper trail for every change.

Governance

Prove it before it ships

Scenario suites run on every change, coverage is measured against decision paths, and every answer comes with a replayable trace.

Testing

Support matrix

Arch Python
linux-x64-gnu ✔️
linux-arm64-gnu ✔️
darwin-x64 ✔️
darwin-arm64 ✔️
win32-x64-msvc ✔️

We do not support linux-musl currently.

Contribution

The JDM standard is growing and we need to keep tight control over its development and roadmap, as a number of companies use GoRules ZEN Engine and GoRules BRMS. For this reason we can't accept code contributions at this moment, apart from help with documentation and additional tests.

License

MIT License

Metadata

Release files for zen-engine 2.1.8

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

Source distribution (sdist)

Source distribution for zen-engine 2.1.8
File Size Uploaded Provenance Actions
zen_engine-2.1.8.tar.gz 730.5 kB Without provenance Details for zen_engine-2.1.8.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for zen-engine 2.1.8
File Actions
zen_engine-2.1.8-cp38-abi3-win_amd64.whl CPython 3.8 abi3 Windows x86-64 Details for zen_engine-2.1.8-cp38-abi3-win_amd64.whl
zen_engine-2.1.8-cp38-abi3-manylinux_2_28_x86_64.whl CPython 3.8 abi3 Linux glibc 2.28+ x86-64 Details for zen_engine-2.1.8-cp38-abi3-manylinux_2_28_x86_64.whl
zen_engine-2.1.8-cp38-abi3-manylinux_2_28_aarch64.whl CPython 3.8 abi3 Linux glibc 2.28+ ARM64 Details for zen_engine-2.1.8-cp38-abi3-manylinux_2_28_aarch64.whl
zen_engine-2.1.8-cp38-abi3-macosx_11_0_arm64.whl CPython 3.8 abi3 macOS 11.0+ ARM64 Details for zen_engine-2.1.8-cp38-abi3-macosx_11_0_arm64.whl
zen_engine-2.1.8-cp38-abi3-macosx_10_12_x86_64.whl CPython 3.8 abi3 macOS 10.12+ x86-64 Details for zen_engine-2.1.8-cp38-abi3-macosx_10_12_x86_64.whl

Total release size: 51.5 MB

Release files / zen_engine-2.1.8.tar.gz

Download URL zen_engine-2.1.8.tar.gz
Size 730.5 kB
Tags Source
SHA-256 checksum
How to use checksums
1412cf232a241870db4ad10a534fa159daa70e928d57a428c50eb47c492530d5
BLAKE2b-256 checksum
How to use checksums
f0cc8960894f3bcaf39ee1829004b1565afac2a08546b72397978e8a3c3b9129
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via maturin/1.16.0

Release files / zen_engine-2.1.8-cp38-abi3-win_amd64.whl

Download URL zen_engine-2.1.8-cp38-abi3-win_amd64.whl
Size 10.8 MB
Tags CPython 3.8 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
07fa33c518ce4a48450ecafb546c411c2244ff3191728e6f175c1bdab2e1c7df
BLAKE2b-256 checksum
How to use checksums
9295c22459fae20b832274a0fd23db6a7c410c161037d7806026140500456505
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via maturin/1.16.0

Release files / zen_engine-2.1.8-cp38-abi3-manylinux_2_28_x86_64.whl

Download URL zen_engine-2.1.8-cp38-abi3-manylinux_2_28_x86_64.whl
Size 10.5 MB
Tags CPython 3.8 Linux glibc 2.28+ x86-64 abi3
SHA-256 checksum
How to use checksums
e2d56f24b53f2f47c05b03e9fb07d5900f2a7d6df0627f26d78da6cf03b64d98
BLAKE2b-256 checksum
How to use checksums
13d38ea3b9eee3fa078c7bb99a5f56212d3d67cdeaf443b0b669e0d0f39906d3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via maturin/1.16.0

Release files / zen_engine-2.1.8-cp38-abi3-manylinux_2_28_aarch64.whl

Download URL zen_engine-2.1.8-cp38-abi3-manylinux_2_28_aarch64.whl
Size 9.7 MB
Tags CPython 3.8 Linux glibc 2.28+ ARM64 abi3
SHA-256 checksum
How to use checksums
b6e5d2c1bffa2542c2737c36368d5bff899e15625b82571929f3a4d47ee51ac4
BLAKE2b-256 checksum
How to use checksums
0a08800fb6cdce2d87211ce8d9a526964758f7de04a8a0f1aebb356b03489747
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via maturin/1.16.0

Release files / zen_engine-2.1.8-cp38-abi3-macosx_11_0_arm64.whl

Download URL zen_engine-2.1.8-cp38-abi3-macosx_11_0_arm64.whl
Size 9.4 MB
Tags CPython 3.8 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
29a16bf17d46f694dde3e753d0c1468e18fcca11d7764aad959ca10abc512196
BLAKE2b-256 checksum
How to use checksums
4e784d305a715fa3c350e58080e5f82eae8f07721eb048f8dc4a36e49b4ac172
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via maturin/1.16.0

Release files / zen_engine-2.1.8-cp38-abi3-macosx_10_12_x86_64.whl

Download URL zen_engine-2.1.8-cp38-abi3-macosx_10_12_x86_64.whl
Size 10.3 MB
Tags CPython 3.8 abi3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
226b90a2599343abf4f286538398256ed48e91de90917eca394af0f663641f26
BLAKE2b-256 checksum
How to use checksums
646d86dce0acdd6604dccd31a5317db01518655e67865759bd29d19e8e32e667
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via maturin/1.16.0

Security for zen-engine 2.1.8

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

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.

Release history Release notifications | RSS feed

This release

2.1.8 This release

6 release files No provenance

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