flowyml 1.1.0__tar.gz

flowyml-1.1.0/LICENSE

@@ -0,0 +1,17 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+Copyright 2024 Flowy Team
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

flowyml-1.1.0/PKG-INFO

@@ -0,0 +1,372 @@
+Metadata-Version: 2.4
+Name: flowyml
+Version: 1.1.0
+Summary: Next-Generation ML Pipeline Framework
+License: Apache-2.0
+License-File: LICENSE
+Author: flowyml Team
+Author-email: support@unicolab.ai
+Requires-Python: >=3.10,<4.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Provides-Extra: all
+Provides-Extra: gcp
+Provides-Extra: pytorch
+Provides-Extra: sklearn
+Provides-Extra: tensorflow
+Provides-Extra: ui
+Requires-Dist: click (>=8.0.0)
+Requires-Dist: croniter (>=2.0.1,<3.0.0)
+Requires-Dist: fastapi (>=0.122.0,<0.123.0) ; extra == "ui"
+Requires-Dist: google-cloud-aiplatform (>=1.35.0) ; extra == "gcp" or extra == "all"
+Requires-Dist: google-cloud-storage (>=2.10.0) ; extra == "gcp" or extra == "all"
+Requires-Dist: loguru (>=0.7.3,<0.8.0)
+Requires-Dist: numpy (>=1.20.0)
+Requires-Dist: pandas (>=1.3.0)
+Requires-Dist: pydantic (>=2.0.0)
+Requires-Dist: python-multipart (>=0.0.6) ; extra == "ui" or extra == "all"
+Requires-Dist: pytz (>=2024.1,<2025.0)
+Requires-Dist: pyyaml (>=6.0)
+Requires-Dist: scikit-learn (>=1.0.0) ; extra == "sklearn" or extra == "all"
+Requires-Dist: tensorflow (>=2.12.0) ; extra == "tensorflow" or extra == "all"
+Requires-Dist: toml (>=0.10.2)
+Requires-Dist: torch (>=2.0.0) ; extra == "pytorch" or extra == "all"
+Requires-Dist: uvicorn[standard] (>=0.23.0) ; extra == "ui" or extra == "all"
+Requires-Dist: websockets (>=11.0) ; extra == "ui" or extra == "all"
+Project-URL: Documentation, https://unicolab.github.io/FlowyML/latest
+Project-URL: Homepage, https://github.com/UnicoLab/FlowyML
+Project-URL: Repository, https://github.com/UnicoLab/FlowyML
+Description-Content-Type: text/markdown
+
+# 🌊 flowyml
+
+<p align="center">
+  <img src="docs/logo.png" width="350" alt="flowyml Logo"/>
+  <br>
+  <em>The Enterprise-Grade ML Pipeline Framework for Humans</em>
+  <br>
+  <br>
+  <p align="center">
+    <a href="https://github.com/UnicoLab/FlowyML/actions"><img src="https://img.shields.io/github/actions/workflow/status/UnicoLab/FlowyML/ci.yml?branch=main" alt="CI Status"></a>
+    <a href="https://pypi.org/project/flowyml/"><img src="https://img.shields.io/pypi/v/flowyml" alt="PyPI Version"></a>
+    <a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/python-3.10+-blue.svg" alt="Python 3.10+"></a>
+    <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-blue.svg" alt="License"></a>
+    <a href="https://unicolab.ai"><img src="https://img.shields.io/badge/UnicoLab-ai-red.svg" alt="UnicoLab"></a>
+  </p>
+</p>
+
+---
+
+**flowyml** is the comprehensive ML pipeline framework that combines the **simplicity of a Python script** with the **power of an enterprise MLOps platform**.
+
+## 🚀 Why flowyml?
+
+| Feature | flowyml | Traditional Orchestrators |
+|---------|---------|---------------------------|
+| **Developer Experience** | 🐍 **Native Python** - No DSLs, no YAML hell. | 📜 Complex YAML or rigid DSLs. |
+| **Context Awareness** | 🧠 **Auto-Injection** - Params are just function args. | 🔌 Manual wiring of every parameter. |
+| **Caching** | ⚡ **Multi-Level** - Smart content-hashing & memoization. | 🐢 Basic file-timestamp checking. |
+| **Asset Management** | 📦 **First-Class Assets** - Models & Datasets with lineage. | 📁 Generic file paths only. |
+| **Architecture** | 🏗️ **Modular Stacks** - Local, Cloud, Hybrid. | 🔒 Vendor lock-in or complex setup. |
+
+## 🚀 Feature Showcase
+
+flowyml is a complete toolkit for building, debugging, and deploying ML applications.
+
+### 1. Zero-Boilerplate Orchestration
+Write pipelines as standard Python functions. No YAML, no DSLs.
+
+```python
+@step(outputs=["data"])
+def load(): return [1, 2, 3]
+
+@step(inputs=["data"], outputs=["model"])
+def train(data): return Model.train(data)
+
+# It's just Python!
+pipeline = Pipeline("simple").add_step(load).add_step(train)
+pipeline.run()
+```
+
+### 2. 🧠 Intelligent Caching
+Don't waste time re-running successful steps.
+- **Code Hash**: Re-runs only when code changes.
+- **Input Hash**: Re-runs only when data changes.
+
+```python
+# Only re-runs if 'data' changes, ignoring code changes
+@step(cache="input_hash", outputs=["processed"])
+def expensive_processing(data):
+    return process(data)
+```
+
+### 3. 🤖 LLM & GenAI Ready
+Trace token usage, latency, and costs automatically.
+
+```python
+@step
+@trace_llm(model="gpt-4", tags=["production"])
+def generate_summary(text: str):
+    # flowyml automatically tracks tokens, cost, and latency
+    return openai.ChatCompletion.create(...)
+```
+
+### 4. ⚡ Efficient Step Grouping
+Group related steps to run in the same container - reduce overhead, maintain clarity.
+
+```python
+# Run preprocessing steps in same container (shares resources)
+@step(outputs=["raw"], execution_group="preprocessing")
+def load(): return fetch_data()
+
+@step(inputs=["raw"], outputs=["clean"], execution_group="preprocessing")
+def clean(raw): return preprocess(raw)
+
+# flowyml automatically aggregates resources (max CPU, memory, best GPU)
+# and executes consecutively in same environment
+```
+
+### 5. 🔀 Dynamic Workflows
+Build adaptive workflows with conditional logic.
+
+```python
+# Run 'deploy' only if model accuracy > 0.9
+pipeline.add_step(
+    If(condition=lambda ctx: ctx["accuracy"] > 0.9)
+    .then(deploy_model)
+    .else_(notify_team)
+)
+```
+
+### 6. 🧩 Universal Plugin System
+Extend flowyml with any tool - even wrap ZenML components!
+
+```python
+from flowyml.stacks.plugins import load_component
+
+# Use any ZenML orchestrator, artifact store, or integration
+k8s_orch = load_component("zenml:zenml.integrations.kubernetes.orchestrators.KubernetesOrchestrator")
+mlflow = load_component("zenml:zenml.integrations.mlflow.MLflowExperimentTracker")
+```
+
+### 7. 👤 Human-in-the-Loop
+Pause pipelines for manual approval or review.
+
+```python
+from flowyml import approval
+
+approval_step = approval(
+    name="approve_deployment",
+    approver="ml-team",
+    timeout_seconds=3600
+)
+```
+
+### 8. 📊 Built-in Experiment Tracking
+No external tools needed - tracking is built-in.
+
+```python
+from flowyml.tracking import Experiment
+
+exp = Experiment("baseline_training")
+exp.log_run(run_id="run_001", metrics={"accuracy": 0.95}, parameters={"lr": 0.01})
+best = exp.get_best_run("accuracy", maximize=True)
+```
+
+### 9. 🏆 Model Leaderboard & Registry
+Track, compare, and version your models.
+
+```python
+from flowyml import ModelLeaderboard
+from flowyml.core import Model
+
+# Track performance
+leaderboard = ModelLeaderboard(metric="accuracy")
+leaderboard.add_score(model_name="bert-base", score=0.92)
+
+# Register models with stages
+model = Model.create(artifact={...})
+model.register(name="text_classifier", stage="production")
+```
+
+### 10. 📅 Built-in Scheduling
+Schedule recurring jobs without external orchestrators.
+
+```python
+from flowyml import PipelineScheduler
+
+scheduler = PipelineScheduler()
+scheduler.schedule_daily(
+    name="daily_training",
+    pipeline_func=lambda: pipeline.run(),
+    hour=2, minute=0
+)
+scheduler.start()
+```
+
+### 11. 🔔 Smart Notifications
+Slack, Email, and custom alerts built-in.
+
+```python
+from flowyml import configure_notifications
+
+configure_notifications(
+    slack_webhook="https://hooks.slack.com/...",
+    email_config={...}
+)
+# Automatic notifications on pipeline success/failure
+```
+
+### 12. 🎯 Step-Level Debugging
+Set breakpoints and inspect state mid-pipeline.
+
+```python
+from flowyml import StepDebugger
+
+debugger = StepDebugger()
+debugger.set_breakpoint("train_model")
+pipeline.run(debug=True)  # Pauses at breakpoint
+```
+
+### 13. 📦 First-Class Assets
+Specialized types for ML workflows.
+
+```python
+from flowyml.core import Dataset, Model, Metrics, FeatureSet
+
+dataset = Dataset.create(data=df, name="training_data")
+model = Model.create(artifact=trained_model, score=0.95)
+metrics = Metrics.create(values={"accuracy": 0.95})
+```
+
+### 14. 🔄 Smart Retries & Circuit Breakers
+Handle failures gracefully.
+
+```python
+@step(retry=3, timeout=300)
+def flaky_api_call():
+    return external_api.fetch()
+
+# Circuit breakers prevent cascading failures
+```
+
+### 15. 📈 Data Drift Detection
+Monitor distribution shifts automatically.
+
+```python
+from flowyml import detect_drift
+
+drift = detect_drift(
+    reference_data=train_feature,
+    current_data=prod_feature,
+    threshold=0.1
+)
+if drift['drift_detected']:
+    trigger_retraining()
+```
+
+### 16. 🔍 Interactive Debugging
+- **StepDebugger**: Set breakpoints in your pipeline.
+- **Artifact Inspection**: View intermediate data in the UI.
+- **Local Execution**: Run the exact same code locally as in production.
+
+### 17. 🏭 Enterprise Production Features
+- **🔄 Automatic Retries**: Handle transient failures.
+- **⏰ Scheduling**: Built-in cron scheduler.
+- **🔔 Notifications**: Slack/Email alerts.
+- **🛡️ Circuit Breakers**: Stop cascading failures.
+
+### 18. 🔌 Universal Integrations
+- **ML Frameworks**: PyTorch, TensorFlow, Keras, Scikit-learn, HuggingFace.
+- **Cloud Providers**: AWS, GCP, Azure (via plugins).
+- **Tools**: MLflow, Weights & Biases, Great Expectations.
+
+## 📦 Installation
+
+```bash
+# Install core
+pip install flowyml
+
+# Install with UI support
+pip install "flowyml[ui]"
+
+# Install with all features (recommended for dev)
+pip install "flowyml[all]"
+```
+
+## ⚡ Quick Start
+
+```python
+from flowyml import Pipeline, step, context, Dataset, Model
+
+# 1. Define your configuration (Auto-injected!)
+ctx = context(
+    learning_rate=0.01,
+    batch_size=32,
+    epochs=10
+)
+
+# 2. Define your steps (Pure Python)
+@step(outputs=["dataset"])
+def load_data(batch_size: int):
+    # 'batch_size' is automatically injected from context!
+    print(f"Loading data with batch size: {batch_size}")
+    return Dataset.create(data=[1, 2, 3], name="mnist")
+
+@step(inputs=["dataset"], outputs=["model"])
+def train(dataset: Dataset, learning_rate: float, epochs: int):
+    print(f"Training on {dataset.name} with lr={learning_rate}")
+    # Simulate training...
+    return Model.create(artifact={"weights": "..."}, score=0.98)
+
+# 3. Run it!
+pipeline = Pipeline("mnist_training", context=ctx)
+pipeline.add_step(load_data)
+pipeline.add_step(train)
+
+result = pipeline.run()
+
+print(f"Run ID: {result.run_id}")
+print(f"Model Score: {result.outputs['model'].score}")
+```
+
+## 🖥️ The flowyml UI
+
+Visualize your workflows, inspect artifacts, and monitor runs in real-time.
+
+```bash
+# Start the UI server
+flowyml ui start --open-browser
+```
+
+Visit **http://localhost:8080** to access the dashboard.
+
+## 📚 Documentation
+
+- **[Getting Started](docs/getting-started.md)**: Your first 5 minutes with flowyml.
+- **[Core Concepts](docs/core/pipelines.md)**: Deep dive into Pipelines, Steps, and Context.
+- **[Advanced Features](docs/advanced/caching.md)**: Learn about Caching, Parallelism, and Conditional Execution.
+- **[API Reference](docs/api/core.md)**: Detailed class and function documentation.
+
+## 🤝 Contributing
+
+We love contributions! Check out our [Contributing Guide](CONTRIBUTING.md) to get started.
+
+## 📝 License
+
+Apache 2.0 - See [LICENSE](LICENSE) for details.
+
+---
+<p align="center">
+  <strong>Built with ❤️ by <a href="https://unicolab.ai">UnicoLab</a></strong>
+</p>
+

flowyml-1.1.0/README.md

@@ -0,0 +1,322 @@
+# 🌊 flowyml
+
+<p align="center">
+  <img src="docs/logo.png" width="350" alt="flowyml Logo"/>
+  <br>
+  <em>The Enterprise-Grade ML Pipeline Framework for Humans</em>
+  <br>
+  <br>
+  <p align="center">
+    <a href="https://github.com/UnicoLab/FlowyML/actions"><img src="https://img.shields.io/github/actions/workflow/status/UnicoLab/FlowyML/ci.yml?branch=main" alt="CI Status"></a>
+    <a href="https://pypi.org/project/flowyml/"><img src="https://img.shields.io/pypi/v/flowyml" alt="PyPI Version"></a>
+    <a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/python-3.10+-blue.svg" alt="Python 3.10+"></a>
+    <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-blue.svg" alt="License"></a>
+    <a href="https://unicolab.ai"><img src="https://img.shields.io/badge/UnicoLab-ai-red.svg" alt="UnicoLab"></a>
+  </p>
+</p>
+
+---
+
+**flowyml** is the comprehensive ML pipeline framework that combines the **simplicity of a Python script** with the **power of an enterprise MLOps platform**.
+
+## 🚀 Why flowyml?
+
+| Feature | flowyml | Traditional Orchestrators |
+|---------|---------|---------------------------|
+| **Developer Experience** | 🐍 **Native Python** - No DSLs, no YAML hell. | 📜 Complex YAML or rigid DSLs. |
+| **Context Awareness** | 🧠 **Auto-Injection** - Params are just function args. | 🔌 Manual wiring of every parameter. |
+| **Caching** | ⚡ **Multi-Level** - Smart content-hashing & memoization. | 🐢 Basic file-timestamp checking. |
+| **Asset Management** | 📦 **First-Class Assets** - Models & Datasets with lineage. | 📁 Generic file paths only. |
+| **Architecture** | 🏗️ **Modular Stacks** - Local, Cloud, Hybrid. | 🔒 Vendor lock-in or complex setup. |
+
+## 🚀 Feature Showcase
+
+flowyml is a complete toolkit for building, debugging, and deploying ML applications.
+
+### 1. Zero-Boilerplate Orchestration
+Write pipelines as standard Python functions. No YAML, no DSLs.
+
+```python
+@step(outputs=["data"])
+def load(): return [1, 2, 3]
+
+@step(inputs=["data"], outputs=["model"])
+def train(data): return Model.train(data)
+
+# It's just Python!
+pipeline = Pipeline("simple").add_step(load).add_step(train)
+pipeline.run()
+```
+
+### 2. 🧠 Intelligent Caching
+Don't waste time re-running successful steps.
+- **Code Hash**: Re-runs only when code changes.
+- **Input Hash**: Re-runs only when data changes.
+
+```python
+# Only re-runs if 'data' changes, ignoring code changes
+@step(cache="input_hash", outputs=["processed"])
+def expensive_processing(data):
+    return process(data)
+```
+
+### 3. 🤖 LLM & GenAI Ready
+Trace token usage, latency, and costs automatically.
+
+```python
+@step
+@trace_llm(model="gpt-4", tags=["production"])
+def generate_summary(text: str):
+    # flowyml automatically tracks tokens, cost, and latency
+    return openai.ChatCompletion.create(...)
+```
+
+### 4. ⚡ Efficient Step Grouping
+Group related steps to run in the same container - reduce overhead, maintain clarity.
+
+```python
+# Run preprocessing steps in same container (shares resources)
+@step(outputs=["raw"], execution_group="preprocessing")
+def load(): return fetch_data()
+
+@step(inputs=["raw"], outputs=["clean"], execution_group="preprocessing")
+def clean(raw): return preprocess(raw)
+
+# flowyml automatically aggregates resources (max CPU, memory, best GPU)
+# and executes consecutively in same environment
+```
+
+### 5. 🔀 Dynamic Workflows
+Build adaptive workflows with conditional logic.
+
+```python
+# Run 'deploy' only if model accuracy > 0.9
+pipeline.add_step(
+    If(condition=lambda ctx: ctx["accuracy"] > 0.9)
+    .then(deploy_model)
+    .else_(notify_team)
+)
+```
+
+### 6. 🧩 Universal Plugin System
+Extend flowyml with any tool - even wrap ZenML components!
+
+```python
+from flowyml.stacks.plugins import load_component
+
+# Use any ZenML orchestrator, artifact store, or integration
+k8s_orch = load_component("zenml:zenml.integrations.kubernetes.orchestrators.KubernetesOrchestrator")
+mlflow = load_component("zenml:zenml.integrations.mlflow.MLflowExperimentTracker")
+```
+
+### 7. 👤 Human-in-the-Loop
+Pause pipelines for manual approval or review.
+
+```python
+from flowyml import approval
+
+approval_step = approval(
+    name="approve_deployment",
+    approver="ml-team",
+    timeout_seconds=3600
+)
+```
+
+### 8. 📊 Built-in Experiment Tracking
+No external tools needed - tracking is built-in.
+
+```python
+from flowyml.tracking import Experiment
+
+exp = Experiment("baseline_training")
+exp.log_run(run_id="run_001", metrics={"accuracy": 0.95}, parameters={"lr": 0.01})
+best = exp.get_best_run("accuracy", maximize=True)
+```
+
+### 9. 🏆 Model Leaderboard & Registry
+Track, compare, and version your models.
+
+```python
+from flowyml import ModelLeaderboard
+from flowyml.core import Model
+
+# Track performance
+leaderboard = ModelLeaderboard(metric="accuracy")
+leaderboard.add_score(model_name="bert-base", score=0.92)
+
+# Register models with stages
+model = Model.create(artifact={...})
+model.register(name="text_classifier", stage="production")
+```
+
+### 10. 📅 Built-in Scheduling
+Schedule recurring jobs without external orchestrators.
+
+```python
+from flowyml import PipelineScheduler
+
+scheduler = PipelineScheduler()
+scheduler.schedule_daily(
+    name="daily_training",
+    pipeline_func=lambda: pipeline.run(),
+    hour=2, minute=0
+)
+scheduler.start()
+```
+
+### 11. 🔔 Smart Notifications
+Slack, Email, and custom alerts built-in.
+
+```python
+from flowyml import configure_notifications
+
+configure_notifications(
+    slack_webhook="https://hooks.slack.com/...",
+    email_config={...}
+)
+# Automatic notifications on pipeline success/failure
+```
+
+### 12. 🎯 Step-Level Debugging
+Set breakpoints and inspect state mid-pipeline.
+
+```python
+from flowyml import StepDebugger
+
+debugger = StepDebugger()
+debugger.set_breakpoint("train_model")
+pipeline.run(debug=True)  # Pauses at breakpoint
+```
+
+### 13. 📦 First-Class Assets
+Specialized types for ML workflows.
+
+```python
+from flowyml.core import Dataset, Model, Metrics, FeatureSet
+
+dataset = Dataset.create(data=df, name="training_data")
+model = Model.create(artifact=trained_model, score=0.95)
+metrics = Metrics.create(values={"accuracy": 0.95})
+```
+
+### 14. 🔄 Smart Retries & Circuit Breakers
+Handle failures gracefully.
+
+```python
+@step(retry=3, timeout=300)
+def flaky_api_call():
+    return external_api.fetch()
+
+# Circuit breakers prevent cascading failures
+```
+
+### 15. 📈 Data Drift Detection
+Monitor distribution shifts automatically.
+
+```python
+from flowyml import detect_drift
+
+drift = detect_drift(
+    reference_data=train_feature,
+    current_data=prod_feature,
+    threshold=0.1
+)
+if drift['drift_detected']:
+    trigger_retraining()
+```
+
+### 16. 🔍 Interactive Debugging
+- **StepDebugger**: Set breakpoints in your pipeline.
+- **Artifact Inspection**: View intermediate data in the UI.
+- **Local Execution**: Run the exact same code locally as in production.
+
+### 17. 🏭 Enterprise Production Features
+- **🔄 Automatic Retries**: Handle transient failures.
+- **⏰ Scheduling**: Built-in cron scheduler.
+- **🔔 Notifications**: Slack/Email alerts.
+- **🛡️ Circuit Breakers**: Stop cascading failures.
+
+### 18. 🔌 Universal Integrations
+- **ML Frameworks**: PyTorch, TensorFlow, Keras, Scikit-learn, HuggingFace.
+- **Cloud Providers**: AWS, GCP, Azure (via plugins).
+- **Tools**: MLflow, Weights & Biases, Great Expectations.
+
+## 📦 Installation
+
+```bash
+# Install core
+pip install flowyml
+
+# Install with UI support
+pip install "flowyml[ui]"
+
+# Install with all features (recommended for dev)
+pip install "flowyml[all]"
+```
+
+## ⚡ Quick Start
+
+```python
+from flowyml import Pipeline, step, context, Dataset, Model
+
+# 1. Define your configuration (Auto-injected!)
+ctx = context(
+    learning_rate=0.01,
+    batch_size=32,
+    epochs=10
+)
+
+# 2. Define your steps (Pure Python)
+@step(outputs=["dataset"])
+def load_data(batch_size: int):
+    # 'batch_size' is automatically injected from context!
+    print(f"Loading data with batch size: {batch_size}")
+    return Dataset.create(data=[1, 2, 3], name="mnist")
+
+@step(inputs=["dataset"], outputs=["model"])
+def train(dataset: Dataset, learning_rate: float, epochs: int):
+    print(f"Training on {dataset.name} with lr={learning_rate}")
+    # Simulate training...
+    return Model.create(artifact={"weights": "..."}, score=0.98)
+
+# 3. Run it!
+pipeline = Pipeline("mnist_training", context=ctx)
+pipeline.add_step(load_data)
+pipeline.add_step(train)
+
+result = pipeline.run()
+
+print(f"Run ID: {result.run_id}")
+print(f"Model Score: {result.outputs['model'].score}")
+```
+
+## 🖥️ The flowyml UI
+
+Visualize your workflows, inspect artifacts, and monitor runs in real-time.
+
+```bash
+# Start the UI server
+flowyml ui start --open-browser
+```
+
+Visit **http://localhost:8080** to access the dashboard.
+
+## 📚 Documentation
+
+- **[Getting Started](docs/getting-started.md)**: Your first 5 minutes with flowyml.
+- **[Core Concepts](docs/core/pipelines.md)**: Deep dive into Pipelines, Steps, and Context.
+- **[Advanced Features](docs/advanced/caching.md)**: Learn about Caching, Parallelism, and Conditional Execution.
+- **[API Reference](docs/api/core.md)**: Detailed class and function documentation.
+
+## 🤝 Contributing
+
+We love contributions! Check out our [Contributing Guide](CONTRIBUTING.md) to get started.
+
+## 📝 License
+
+Apache 2.0 - See [LICENSE](LICENSE) for details.
+
+---
+<p align="center">
+  <strong>Built with ❤️ by <a href="https://unicolab.ai">UnicoLab</a></strong>
+</p>