Quickstart

Get IronLayer running locally and generate your first execution plan.

Prerequisites

  • Python 3.11+
  • Git
  • A Databricks workspace (for execution — optional for local planning)

Install

pip install -e core_engine/ -e api/ -e cli/

Start the local dev server

docker compose up -d

This starts PostgreSQL, the API, the AI engine, and the frontend. The dashboard is available at http://localhost:3000.

Connect to a running instance

ironlayer login
# Enter your API URL and credentials

Generate your first plan

ironlayer plan . HEAD~1 HEAD

This compares the last two commits in the current repo, discovers changed SQL models, builds a dependency DAG, and generates a deterministic execution plan.

View the plan

ironlayer show <plan_id>

Apply the plan

ironlayer apply <plan_id> --auto-approve

Import from dbt

If you have an existing dbt project, import it with one command:

ironlayer migrate from-dbt ./my-dbt-project

Next steps