Fluid Forge
Why Forge
Concepts
Get Started
  • Consume a Data Product
  • See it run
  • Demos
  • Local (DuckDB)
  • Source-Aligned (Postgres → DuckDB)
  • AI Forge + Data Models
  • MCP Output Port — Serve to AI Agents
  • GCP (BigQuery)
  • Snowflake Team Collaboration
  • Declarative Airflow
  • Orchestration Export
  • Jenkins CI/CD
  • Universal Pipeline
  • 11-Stage Production Pipeline
  • Catalog Forge End-to-End
CLI Reference
  • Agent Policy (concept)
  • MCP Output Port — Serve to Agents
  • MCP deep-dive
  • AI-assisted authoring
  • LLM providers & backends
  • Overview
  • Quickstart
  • Examples
  • Your own CI
  • Your own scaffolding
  • Custom validator
  • Apply hook
  • Reference
  • Overview
  • Architecture
  • GCP (BigQuery)
  • AWS (S3 + Athena)
  • Snowflake
  • Local (DuckDB)
  • Custom Providers
  • Roadmap
GitHub
Why Forge
Concepts
Get Started
  • Consume a Data Product
  • See it run
  • Demos
  • Local (DuckDB)
  • Source-Aligned (Postgres → DuckDB)
  • AI Forge + Data Models
  • MCP Output Port — Serve to AI Agents
  • GCP (BigQuery)
  • Snowflake Team Collaboration
  • Declarative Airflow
  • Orchestration Export
  • Jenkins CI/CD
  • Universal Pipeline
  • 11-Stage Production Pipeline
  • Catalog Forge End-to-End
CLI Reference
  • Agent Policy (concept)
  • MCP Output Port — Serve to Agents
  • MCP deep-dive
  • AI-assisted authoring
  • LLM providers & backends
  • Overview
  • Quickstart
  • Examples
  • Your own CI
  • Your own scaffolding
  • Custom validator
  • Apply hook
  • Reference
  • Overview
  • Architecture
  • GCP (BigQuery)
  • AWS (S3 + Athena)
  • Snowflake
  • Local (DuckDB)
  • Custom Providers
  • Roadmap
GitHub
  • Introduction

    • Home
    • Why Fluid Forge
    • Getting Started
    • Snowflake Quickstart
    • See it run
    • Forge Data Model
    • Vision & Roadmap
    • Playground
    • FAQ
  • Concepts

    • Concepts
    • Builds, Exposes, Bindings
    • What is a contract?
    • Quality, SLAs & Lineage
    • Governance & Policy
    • Agent Policy (LLM/AI governance)
    • Providers vs Platforms
    • Fluid Forge vs alternatives
  • Data Products

    • Consume a Data Product
    • Product Types — SDP, ADP, CDP
  • Walkthroughs

    • Walkthrough: Local Development
    • Source-Aligned: Postgres → DuckDB → Parquet
    • AI Forge And Data-Model Journeys
    • Walkthrough: MCP Output Port
    • Walkthrough: Deploy to Google Cloud Platform
    • Walkthrough: Snowflake Team Collaboration
    • Declarative Airflow DAG Generation - The FLUID Way
    • Generating Orchestration Code from Contracts
    • Jenkins CI/CD for FLUID Data Products
    • Universal Pipeline
    • The 11-Stage Pipeline
    • End-to-End Walkthrough: Catalog → Contract → Transformation
  • CLI Reference

    • CLI Reference
    • Core workflow

      • fluid init
      • fluid demo
      • fluid forge
      • fluid validate
      • fluid plan
      • fluid apply
      • fluid diff
      • fluid status
    • Build & ship

      • fluid bundle
      • fluid generate
      • fluid generate artifacts
      • fluid validate-artifacts
      • fluid verify-signature
      • fluid generate iac
      • fluid generate-airflow
      • fluid generate-pipeline
      • fluid viz-graph
      • fluid publish
      • fluid ship
      • fluid rollback
      • fluid schedule-sync
    • AI & Agents

      • fluid ai
      • fluid agents
      • fluid mcp
      • fluid memory
      • fluid stats
      • fluid skills
    • Quality & governance

      • fluid test
      • fluid verify
      • fluid contract-tests
      • fluid contract-validation
      • fluid policy
      • fluid policy check
      • fluid policy compile
      • fluid policy apply
    • Standards & interoperability

      • fluid odps
      • fluid odps-bitol
      • fluid odcs
      • fluid export
      • fluid export-odps
      • fluid exporters
      • fluid import
      • fluid market
      • fluid datamesh-manager
    • Project & workspace

      • fluid product-new
      • fluid product-add
      • fluid workspace
      • fluid contract
      • fluid split
      • fluid config
      • fluid providers
      • fluid plugins
      • fluid provider-init
      • fluid auth
      • fluid secrets
      • fluid ide
      • fluid scaffold-ci
      • fluid scaffold-composer
      • fluid scaffold-ide
      • fluid docs
      • fluid runs
      • fluid retention
      • fluid describe
      • fluid doctor
      • fluid roadmap
      • fluid version
    • Catalog adapters

      • Source Catalog Integration (V1.5)
      • Publishing to a Catalog — Overview
      • BigQuery Catalog
      • Snowflake Horizon Catalog
      • Databricks Unity Catalog
      • Google Dataplex Catalog
      • AWS Glue Data Catalog
      • DataHub Catalog
      • Data Mesh Manager Catalog
      • OpenMetadata Catalog
    • CLI by task

      • CLI by task
      • Add quality rules
      • Add agent governance
      • Debug a failed pipeline run
      • Switch clouds with one line
  • Recipes

    • Recipes
    • Recipe — add a quality rule
    • Recipe — switch clouds with one line
    • Recipe — tag PII in your schema
    • Write a contract that consumes another contract
    • Generate per-environment overlays
  • SDK & Plugins

    • SDK & Plugins
    • Quickstart — your first plugin
    • Examples

      • Runnable examples
      • Example: hello-scaffold — the minimal viable plugin
      • Example: gitlab-ci-scaffold — generate a complete CI project
      • Example: steward-validator — a custom governance rule
      • Example: prod-key-guard — apply-time invariant check
    • Journeys

      • Journeys
      • Your own CI/CD

        • You have your own CI/CD setup, no problem
        • GitLab CI — the bundle template
        • GitHub Actions — the bundle template
        • Jenkins — the bundle template
        • CircleCI — the bundle template
      • You have a strict project layout, no problem
      • You have governance rules, no problem
      • You want a check at apply time, no problem
    • Reference

      • Reference
      • Roles reference
      • Entry points reference
      • Trust model
      • Packaging
      • Companion packages
  • Providers

    • Providers
    • Provider Architecture
    • GCP Provider
    • AWS Provider
    • Snowflake Provider
    • Local Provider
    • Creating Custom Providers
    • Provider Roadmap
  • AI & Agents

    • MCP Server
    • Built-in And Custom Forge Guidance
    • Forge Discovery Guide
    • Forge Memory Guide
    • Authoring Forge Tools
    • Guided fluid forge UX
    • LLM Providers
    • LiteLLM Backend
    • Capability Warnings
    • Cost Tracking
    • FLUID Forge Contract GPT Packet
    • Agentic Primitives
  • Operate & Deploy

    • Airflow Integration
    • Blueprints
    • Source-Aligned Acquisition
  • Govern & Secure

    • Governance, Compliance & the Business Case
    • Governance & Compliance
    • Network Safety
    • Credential Resolver — Security Model
  • Configuration & Reference

    • Environment Variables
    • Typed Errors
    • Typed CLI Errors
    • API Stability — fluid_build.api
  • Architecture & Releases

    • V1.5 Catalog Integration — Architecture Deep-Dive
    • V1.5 + V2 Hardening — Release Notes
  • Project

    • Contributing to Fluid Forge
    • Fluid Forge Docs Baseline: CLI 0.9.0
    • Fluid Forge Docs Baseline: CLI 0.8.11
    • Fluid Forge Docs Baseline: CLI 0.8.10
    • Fluid Forge Docs Baseline: CLI 0.8.9
    • Fluid Forge Docs Baseline: CLI 0.8.8
    • Fluid Forge Docs Baseline: CLI 0.8.7
    • Fluid Forge Docs Baseline: CLI 0.8.6
    • Fluid Forge Docs Baseline: CLI 0.8.5
    • Fluid Forge Docs Baseline: CLI 0.8.4
    • Fluid Forge Docs Baseline: CLI 0.8.3
    • Fluid Forge Docs Baseline: CLI 0.8.0
    • Fluid Forge Docs Baseline: CLI 0.7.11
    • Fluid Forge Docs Baseline: CLI 0.7.9
    • Fluid Forge v0.7.1 - Multi-Provider Export Release

Provider Roadmap

Current Status

ProviderPlan / ApplyCode GenerationData CatalogAvailability
GCP✅ Production✅ Airflow, Dagster, Prefect✅ ODPS, ODCSAvailable Now
AWS✅ Production✅ Airflow, Dagster, Prefect✅ ODPS, ODCSAvailable Now
Snowflake✅ Production✅ Airflow, Dagster, Prefect✅ ODPS, ODCSAvailable Now
Local (DuckDB)✅ ProductionN/AN/AAvailable Now
Datamesh Manager✅ ProductionN/A✅ CatalogAvailable Now
Azure🔜 Planned🔜 Planned🔜 PlannedQ3 2026
Databricks🔜 Planned🔜 Planned🔜 PlannedQ4 2026

Legend:

  • Plan / Apply: fluid plan + fluid apply — Deploy actual cloud resources
  • Code Generation: fluid generate-airflow / fluid export — Generate orchestration code
  • Data Catalog: fluid odps / fluid odcs — Export to open data standards (these are spec exporters, not providers — see fluid exporters)

"Production" scopes the plan/apply core, not every sub-feature

The "✅ Production" / GA status above refers to the provisioning core (plan/apply via OpenTofu, code generation, standards export). Fine-grained governance does not have parity across the three clouds: AWS Lake Formation is supported; Snowflake masking / row-access policies are Beta (created but not yet attached); and GCP fine-grained controls (RLS, policy tags, data masking, VPC-SC) are roadmap, not shipped. See each provider page for the current governance surface.


AWS Provider

Status: ✅ Production Ready (GA since CLI v0.8.0)

Infrastructure Deployment (Available Now)

fluid apply compiles the contract to OpenTofu (main.tf.json) and runs tofu — the older per-service "action handler" code has been retired in favour of this model. Resources emitted by the AWS IaC plugin include:

  • ✅ Amazon S3 — Buckets, versioning, tags, cross-account bucket policy
  • ✅ AWS Glue — Data catalog databases and tables (with column comments / table parameters)
  • ✅ AWS Lake Formation — Admins, LF-tags (TBAC), location registration, principal/column grants, row filters
  • ✅ AWS IAM — Role and policy bindings from accessPolicy

Other AWS services may be reachable through the IaC layer, but they are no longer modelled as discrete "service action handlers". fluid generate iac <contract> shows exactly what is emitted.

Code Generation (Available Now)

Generate production-ready orchestration code:

# Generate Airflow DAG
fluid generate-airflow aws-contract.yaml -o dags/aws_pipeline.py

# With verbose output
```bash
# Airflow
fluid generate-airflow aws-contract.yaml -o dags/pipeline.py --verbose

# Dagster
fluid export aws-contract.yaml --engine dagster -o pipelines/

# Prefect
fluid export aws-contract.yaml --engine prefect -o flows/

Generated Code Quality:

  • Valid Python syntax
  • Error handling and retries
  • Logging and monitoring integration
  • Resource cleanup and rollback

Snowflake Provider

Status: ✅ Production Ready (GA since CLI v0.8.0)

Infrastructure Deployment (Available Now)

Full plan/apply lifecycle. The Snowflake IaC plugin emits:

  • ✅ Databases & Schemas — Lifecycle management
  • ✅ Tables & Views — DDL with clustering
  • ✅ Streams & Tasks — CDC streams and scheduled tasks
  • ✅ Procedures & Functions — Stored procedures and UDFs
  • ✅ RBAC Grants — GRANT ... TO ROLE from the contract
  • 🧪 Masking & Row-Access policies — policy objects created, not yet attached (Beta)

Snowpipe, Snowpark, and Data Sharing are not yet emitted by the Snowflake plugin — see the Snowflake provider page for the current surface.

Code Generation (Available Now)

# Airflow
fluid generate-airflow snowflake-contract.yaml -o dags/snowflake_pipeline.py

# Dagster
fluid export snowflake-contract.yaml --engine dagster -o pipelines/

# With environment overlay
fluid generate-airflow snowflake-contract.yaml --env prod -o dags/prod_pipeline.py

Supported Operations:

  • ✅ Database and schema creation
  • ✅ Table and view creation with clustering
  • ✅ Streams, tasks, procedures, and functions
  • ✅ RBAC grants from the contract

GCP Provider

Status: ✅ Production Ready (GA since CLI v0.8.0)

The flagship provider with the most mature implementation:

  • ✅ BigQuery — Datasets, tables, views, routines
  • ✅ Cloud Storage — Buckets and objects
  • ✅ Pub/Sub — Topics and subscriptions
  • ✅ Cloud Functions — Serverless compute
  • ✅ Cloud Composer — Managed Airflow
  • ✅ Dataflow — Streaming and batch
  • ✅ IAM — Automated role bindings

Code Generation

# All three engines supported
fluid generate-airflow gcp-contract.yaml -o dags/pipeline.py
fluid export gcp-contract.yaml --engine dagster -o pipelines/
fluid export gcp-contract.yaml --engine prefect -o flows/

Standards exporters and catalogs

ODPS and ODCS are spec exporters, not cloud providers — they serialize a contract to an open standard and do not deploy infrastructure. The full list is surfaced by fluid exporters. Datamesh Manager is a catalog target reached via fluid publish.

ODPS (Open Data Product Specification)

Status: ✅ Available Now

fluid export-odps contract.yaml --out catalog/
fluid odps validate catalog/product.yaml

ODCS (Open Data Contract Standard)

Status: ✅ Available Now

fluid odcs export contract.yaml -o contracts/
fluid odcs validate contracts/contract.yaml

Datamesh Manager

Status: ✅ Available Now

fluid market list
fluid publish contract.yaml

Planned Providers

Azure (Q3 2026)

Target Services:

  • Azure Data Lake Gen2 — Storage
  • Azure Synapse Analytics — Warehouse
  • Azure Databricks — Spark platform
  • Azure Functions — Serverless compute
  • Azure Data Factory — Orchestration

Databricks (Q4 2026)

Target Services:

  • Databricks SQL — Analytics
  • Delta Lake — Storage format
  • MLflow — ML lifecycle
  • Unity Catalog — Governance

Community Providers

Want a provider not on the roadmap? Contribute!

Fluid Forge is designed for extensibility. Community providers welcome for:

  • Apache Iceberg
  • Apache Hudi
  • ClickHouse
  • Trino/Presto
  • PostgreSQL
  • MySQL/MariaDB

How to contribute:

  1. Implement BaseProvider interface
  2. Add provider-specific actions
  3. Write tests
  4. Submit PR!

Multi-Cloud Features

Cross-Cloud Data Products

Deploy the same contract to multiple clouds:

fluidVersion: "0.7.3"
kind: DataProduct
id: analytics.multi_cloud_analytics
name: Multi-Cloud Analytics

metadata:
  layer: Gold
  owner:
    team: data-engineering
    email: data-engineering@company.com

exposes:
  - exposeId: analytics
    kind: table
    title: Multi-Cloud Analytics Table
    version: "1.0.0"

    binding:
      platform: gcp                # or aws, snowflake
      format: bigquery_table       # provider-specific format
      location:
        project: my-project
        dataset: analytics
        table: analytics

    contract:
      schema:
        - name: id
          type: STRING
          required: true

The same contract structure works across GCP, AWS, and Snowflake — just change binding.platform (and the matching binding.format / binding.location).


Request a Provider

Vote for providers or request new ones:

  • 🗳️ Provider Feature Requests
  • 💬 GitHub Discussions
  • 📋 Open a provider request issue

Next Steps

Available Now:

  • GCP Provider - Production ready
  • Local Provider - Development & testing

Get Started:

  • GCP Walkthrough - Deploy to Google Cloud
  • Local Walkthrough - Try it locally first

Building the future of declarative data infrastructure, one provider at a time.

Edit this page on GitHub
Last Updated: 6/27/26, 4:58 PM
Contributors: Jeff Watson, jeffwatson-ai, fas89, Claude Opus 4.7 (1M context)
Prev
Creating Custom Providers