orche 0.5.1

A simple, lightweight Python orchestrator for Docker Compose stacks

Orche

A simple, lightweight Python orchestrator for Docker Compose stacks.

Define your stack logic in an orchefile.py, register commands with decorators, and run everything through the orche CLI.

[!IMPORTANT] Orche is a thin orchestration layer on top of Docker Compose. It does not replace Docker — it coordinates what happens around it.

Installation

pip install orche

Quick Start

Create an orchefile.py in your project root:

from orche import Stack

stack = Stack(
    name="myapp",
    compose_files=["docker-compose.yml"],
)

@stack.commands.up
def up():
    stack.build().up()

@stack.commands.down
def down():
    stack.down(volumes=True)

Then run:

orche up
orche down

# Chain commands with commas
orche build, up

Documentation

Full documentation is available here:

• Installation
• Quick Start
• CLI Reference
• Guides: Hooks \ Services
• API: Stack \ Command Registry \ Built-in Utilities \ Exceptions

Requirements

• Python >= 3.10
• Docker and Docker Compose installed on the system

Development

Orche uses uv for dependency management.

uv sync --extra dev
uv run pytest
uv run mypy orche
uv run ruff check orche