---
canonical: https://docs.jentic.com/reference/arazzo-engine/development/
representation: markdown-alternate
# Canonical page: https://docs.jentic.com/reference/arazzo-engine/development/
# This is the Markdown alternate of the page above.
title: "Jentic Arazzo Engine — Development Guide"
description: >-
  Set up a local development environment for the Arazzo Engine: prerequisites, cloning
  the repository, installing dependencies, and running the test suite.
---

# Arazzo Engine – Development Guide

This page explains how to set up a development environment for **Arazzo Engine**.

---

## 1. Prerequisites

- Python **3.9+**
- Git
- [Poetry](https://python-poetry.org/) or `pip` for dependency management
- Make (optional, for convenience)

---

## 2. Clone and Install

```bash
git clone https://github.com/jentic/arazzo-engine.git
cd arazzo-engine
make install
````

Or with Poetry:

```bash
poetry install
```

---

## 3. Project Structure

```
arazzo-engine/
├── runner/                # Arazzo Runner CLI + Python library
├── tests/                 # Unit and integration tests
├── examples/              # Sample workflows
├── pyproject.toml         # Dependencies & build config
└── README.md
```

---

## 4. Running Tests

```bash
pytest
```

Run with coverage:

```bash
pytest --cov=arazzo_engine
```

---

## 5. Contributing

1. **Fork** the repository
2. Create a feature branch:

   ```bash
   git checkout -b feature/my-new-feature
   ```
3. Commit changes and push:

   ```bash
   git push origin feature/my-new-feature
   ```
4. Open a Pull Request on GitHub

---

## 6. Community

* 💬 [Discord](https://discord.gg/yrxmDZWMqB)
* 🐛 [GitHub Issues](https://github.com/jentic/arazzo-engine/issues)
* 💡 [GitHub Discussions](https://github.com/jentic/arazzo-engine/discussions)

---

> **License:** MIT — free to use, modify, and distribute.