diff --git a/README.md b/README.md index e6283d7f0..8743827fe 100644 --- a/README.md +++ b/README.md @@ -53,6 +53,39 @@ under the License. Apache Hamilton (incubating) is a lightweight Python library for directed acyclic graphs (DAGs) of data transformations. Your DAG is **portable**; it runs anywhere Python runs, whether it's a script, notebook, Airflow pipeline, FastAPI server, etc. Your DAG is **expressive**; Apache Hamilton has extensive features to define and modify the execution of a DAG (e.g., data validation, experiment tracking, remote execution). +## Quick Start (2 minutes) + +Get started with Apache Hamilton in just a few lines of code: + +```python +# Step 1: Install (run in terminal) +# pip install sf-hamilton + +# Step 2: Define your functions (nodes in the DAG) +def A() -> int: + return 1 + +def B(A: int) -> int: + return A + 1 + +# Step 3: Execute the DAG +from hamilton import driver + +dr = driver.Driver({}, __name__) +result = dr.execute(["B"]) + +print(result) + +Expected output: {'B': 2} + +## What’s happening? + +Each function becomes a node in the DAG +Dependencies are defined through function parameters +Hamilton automatically builds and executes the dependency graph + +This is the simplest possible pipeline — from here, you can scale to ML workflows, ETL pipelines, and production data systems. + To create a DAG, write regular Python functions that specify their dependencies with their parameters. As shown below, it results in readable code that can always be visualized. Apache Hamilton loads that definition and automatically builds the DAG for you!