Transform any Python function into a portable, trackable pipeline in seconds.
Your existing function (unchanged!):
def analyze_sales(): total_revenue = 50000 best_product = "widgets" return total_revenue, best_productMake it runnable everywhere:
from runnable import PythonJob def main(): PythonJob(function=analyze_sales).execute() if __name__ == "__main__": main()π Success! Your function now runs the same on laptop, containers, and Kubernetes with automatic tracking and reproducibility.
def load_customer_data(): return {"count": 1500, "segments": ["premium", "standard"]} def analyze_segments(customer_data): # Name matches = automatic connection return {"premium_pct": 30, "growth_potential": "high"} # What Runnable needs (same logic, no glue): from runnable import Pipeline, PythonTask def main(): Pipeline(steps=[ PythonTask(function=load_customer_data, returns=["customer_data"]), PythonTask(function=analyze_segments, returns=["analysis"]) ]).execute() if __name__ == "__main__": main()Same pipeline runs unchanged on laptop, containers, and Kubernetes.
pip install runnableFor development:
uv sync --all-extras --devRun examples:
uv run examples/01-tasks/python_tasks.py- π― Easy to adopt: Your code remains as-is, no decorators or imposed structure
- ποΈ Bring your infrastructure: Works with your platforms, not a replacement
- π Reproducibility: Automatic tracking without additional code
- π Retry failures: Debug anywhere, retry from failure points
- π§ͺ Testing: Mock/patch pipeline steps, test functions normally
- π Move on: Easy removal - just delete runnable files, your code stays
Simple sequential execution of Python functions, notebooks, or shell scripts.
Execute multiple branches simultaneously for improved performance.
Execute pipelines over iterable parameters for batch processing.
Combine parallel, map, and sequential patterns as needed.
| Runnable | Kedro | Metaflow | Airflow | |
|---|---|---|---|---|
| Zero Code Changes | β Wrap existing functions | β Restructure to nodes | β Convert to FlowSpec | β Rewrite as DAG tasks |
| Environment Portability | Same code: laptopβcontainerβK8sβArgo | Deployment-specific configs | AWS-focused with --with flags | Platform-specific operators |
| Mixed Task Types | Python + Notebooks + Shell | Python nodes only | Python steps only | Requires separate operators |
| Plugin Extensibility | Auto-discovery via entry points | kedro-* packages | Limited extensions | Complex plugin development |
| Parameter Passing | Automatic by name matching | Manual catalog definitions | Flow state management | Manual XCom operations |
Runnable:
pip install runnable # Wrap your existing function - done!Others:
- Learn framework conventions
- Restructure existing code
- Configure project structure
- Set up deployment configs
Ready to get started? Check out our 30-second demo for immediate results!
