# Ledgence documentation

> Documentation for the Ledgence 0.1 release series: open-source agent and workflow orchestration.

Product source: v0.1.1 (57085da963e8c5bfa0b2fe6ad70e7e3d23cf73be). Documentation checkout: f04b232199eb3a9d29958052d8fc08d5ccb114b3.

Native bundle: 0.1.0 (macOS Apple Silicon). Python client: 0.1.1. Rust API crates: 0.1.1.
Public APIs may change before 1.0. See the release reference for installation choices and supported scope.

## Tutorials

- [Run your first workflow](https://docs.ledgence.com/markdown/tutorials/first-workflow.md): Follow a real workflow from concurrent local steps to a distributed task and a resumed continuation.
- [Run Ledgence locally](https://docs.ledgence.com/markdown/tutorials/run-locally.md): Start a local stack, publish its example agents, and observe real task and workflow results.

## How-to guides

- [Install the native tools](https://docs.ledgence.com/markdown/how-to/install-native.md): Download and verify the macOS Apple silicon release, then run the bundled worker with your host Python.
- [Run tasks in parallel](https://docs.ledgence.com/markdown/how-to/parallel-tasks.md): Stage independent child tasks, wait for their terminal outcomes, and collect successful results.
- [Wait for an external event](https://docs.ledgence.com/markdown/how-to/wait-for-event.md): Checkpoint an approval wait, send a directly addressed CloudEvent, and handle timeout or uncertain acceptance.

## Reference

- [Python client](https://docs.ledgence.com/markdown/reference/python-client.md): Core submission, observation, task discovery, and external-event APIs in ledgence.client.
- [Releases and packages](https://docs.ledgence.com/markdown/reference/releases.md): Published Ledgence versions, installation channels, supported platforms, and the scope of each distribution.
- [Workflow context](https://docs.ledgence.com/markdown/reference/workflow-context.md): Properties, decisions, child operations, and inline limits for Python checkpoint workflows.

## Concepts

- [Checkpoints and recovery](https://docs.ledgence.com/markdown/concepts/checkpoints-and-recovery.md): Understand what survives an activation retry, why explicit continuations matter, and where effects can repeat.
- [How work runs](https://docs.ledgence.com/markdown/concepts/execution-model.md): Understand programs, tasks, workers, and workflows—and choose where work belongs.