English | 中文

Maia

Maia is a self-hosted DAG workflow orchestration and execution service for long-running automation—observable, debuggable, and replayable.

• Persistence: state and outputs are persisted with SQLite (retained and traceable)
• Observability: real-time logs/event streams (SSE) with replay
• Isolated execution: optional Runner + Sandbox container isolation (recommended for production)
• Composable: each step has explicit inputs/outputs and can produce artifacts
• Optional agent: helps generate/refine workflows (opt-in)

Tip

This article includes more demo examples Maia - Self-hosted DAG workflow orchestration and execution service

Quick start

Docker self host

Prerequisites: Docker + Docker Compose v2.

1. Download docker-compose.release.yml and .env.production

curl -fsSL -o docker-compose.release.yml https://raw.githubusercontent.com/obiscr/maia/main/docker-compose.release.yml
curl -fsSL -o .env.production https://raw.githubusercontent.com/obiscr/maia/main/env.example

2. Edit .env.production file and setup RUNNER_TOKEN

RUNNER_TOKEN=your-token

3. Start

docker compose -f docker-compose.release.yml --env-file .env.production up -d

Open http://localhost:3690 to setup。

Run locally with Dev

See Run locally with Dev

Run locally with Docker

See Run locally with Docker

Releases

• Changelog: CHANGELOG.md

Project links

• Documentation maia.obiscr.com
• Contributing: CONTRIBUTING.md
• Security: SECURITY.md
• Code of Conduct: CODE_OF_CONDUCT.md
• Codebase conventions: docs/CODEBASE_CONVENTIONS.md

Credits

• Color palette inspiration and some CSS references: Starlight (MIT): https://github.com/withastro/starlight
• UI component design (in part) inspiration: GitHub Actions: https://github.com/features/actions
• Third-party notices: THIRD_PARTY_NOTICES.md

License

MIT (see LICENSE).