FLUID

Federated Layered Unified Interchange Definition

The open, declarative standard for Data Products — built for the agentic era.

📖 Documentation · 🧭 Schema Anatomy · 🚀 Examples · 🔄 vs ODCS / ODPS · ✨ What's New

---

FLUID is one YAML file that describes a data product end to end — schema, build, orchestration, agentic governance, sovereignty, and semantics. Write it once; validate it, compile it, and deploy it anywhere. It compiles to Bitol ODPS + ODCS for catalog interop via the reference implementation, forge-cli.

How the pieces fit

flowchart LR
    F["FLUID v0.7.5<br/>your .fluid.yml<br/>complete on its own"]
    FC["forge-cli<br/>compiler → IaC + DAGs"]
    BIT["Bitol ODPS + ODCS<br/>catalog interop"]
    F -.->|compile + deploy| FC
    F -.->|catalog interop| BIT

Loading

FLUID is standalone — the contract is complete on its own. Everything else is an optional adapter.

Minimal valid contract

fluidVersion: "0.7.5"
kind: DataProduct
id: demo.bronze.hello_world
name: Hello World
metadata:
  owner:
    team: data-platform
exposes:
  - exposeId: hello
    kind: table
    contract:
      schema:
        - name: id
          type: STRING
          required: true
    binding:
      platform: local
      format: parquet
      location:
        path: ./hello.parquet

→ Build it up step by step in FLUID by Example.

JSON Schema

• Latest stable: 0.7.5 — https://open-data-protocol.github.io/fluid/schema/fluid-schema-0.7.5.json
• Preview: 0.7.6 — https://open-data-protocol.github.io/fluid/schema/fluid-schema-0.7.6.json. A contract uses it only by declaring fluidVersion: "0.7.6", and it can still change before it is promoted to stable. See Stable and preview versions and What's new in 0.7.6.
• A document is validated against the schema of the fluidVersion it declares. To use a field, declare the version that added it — see Choosing fluidVersion.
• Editor support — add this line to a file that declares fluidVersion: "0.7.5" (use the URL matching the version the file declares):

  # yaml-language-server: $schema=https://open-data-protocol.github.io/fluid/schema/fluid-schema-0.7.5.json

• All versions, diffs, and the generated HTML reference: Schema → Versions.

0.7.5 is additive over 0.7.4: every valid 0.7.4 contract stays valid when it declares "0.7.5". See What's New in 0.7.5.

Validate a contract

With a JSON Schema Draft 2020-12 validator, against the schema of the declared version (validators that compile pattern as ECMA-262, as JavaScript ones do, should read the known interoperability issue first). Or with the reference implementation, data-product-forge:

pip install data-product-forge
fluid validate contract.fluid.yaml

Build the docs locally

npm install
npm run docs:dev      # http://localhost:8080/fluid/
npm run docs:build    # static site → docs/.vuepress/dist

The site is built with VuePress 2 and deployed to GitHub Pages. Schema files and the generated HTML specs are mirrored into the published site by scripts/sync-public-assets.mjs, so …/fluid/schema/*.json keeps resolving.

Contributing & license

PRs welcome — see the Contributing Guide. Licensed under the Apache License 2.0.