---
canonical: https://docs.jentic.com/getting-started/arazzo-runner/
representation: markdown-alternate
# Canonical page: https://docs.jentic.com/getting-started/arazzo-runner/
# This is the Markdown alternate of the page above.
title: "Run Arazzo Workflows — Jentic Arazzo Runner"
description: >-
  Get started with Arazzo Runner, the engine that executes Arazzo workflows and OpenAPI
  operations with authentication, dynamic parameters, and reusable logic.
---

# Arazzo Runner – Getting Started

Arazzo Runner is the **workflow execution engine** for running API workflows defined in the **Arazzo specification** and API operations defined in **OpenAPI**.
It powers agents and automation by orchestrating **multi-step API flows** with authentication, dynamic parameters, and reusable logic.

> **Status:** Beta – actively evolving. Contributions and feedback are welcome.

---

## Quick Start (60 seconds)

1. **Install**

   ```sh
   pip install arazzo-runner
   ```

   or

   ```sh
   uv add arazzo-runner
   ```

2. **Run a workflow**

   ```sh
   uvx arazzo-runner execute-workflow ./myworkflow.arazzo.yaml \
     --workflow-id myWorkflow \
     --inputs '{"param1": "value1"}'
   ```

3. **List workflows**

   ```sh
   uvx arazzo-runner list-workflows ./myworkflow.arazzo.yaml
   ```

4. **Show authentication variables**

   ```sh
   uvx arazzo-runner show-env-mappings ./myworkflow.arazzo.yaml
   ```

---

## Key Features

* **Execute Arazzo workflows** or individual OpenAPI operations
* **Automatic authentication handling** (API Key, OAuth2, Basic/Bearer)
* **Dynamic server URL resolution**
* **Blob storage support** for large binary payloads
* **CLI + Python API** for flexible integration

---

## Learn More

* **CLI Reference:** [Arazzo Runner Commands](../cli/arazzo-runner.md)
* **Arazzo Spec:** [Arazzo Format Documentation](https://github.com/jentic/arazzo-engine/blob/main/runner/arazzo_spec/arazzo-spec.md)
* **Examples:** [Runner Examples](https://github.com/jentic/arazzo-engine/tree/main/runner/examples)

---

## Contributing

Arazzo Runner is open source.
If you’d like to:

* Report a bug
* Request a feature
* Improve docs or examples

Open an issue in the repo → [jentic/arazzo-engine](https://github.com/jentic/arazzo-engine/issues)