Duron
Duron is a lightweight durable execution runtime for Python async workflows. It provides replayable execution primitives that work standalone or as building blocks for complex workflow engines.
- 🪶 Zero extra deps — Lightweight library that layers on top of asyncio; add Duron without bloating your stack.
- 🧩 Pluggable architecture — Bring your own storage or infra components and swap them without changing orchestration code.
- 🔄 Streams & signals — Model long-running conversations, live data feeds, and feedback loops with built-in primitives.
- 🐍 Python-native & typed — Type hints make replay serialization predictable, and everything feels like idiomatic Python.
- 🔭 Built-in tracing — Detailed logs help you inspect replays and surface observability data wherever you need it.
Install
Duron requires Python 3.10+.
uv pip install duron
Quickstart
Duron wraps async orchestration (@duron.durable) and effectful steps (@duron.effect) so complex workflows stay deterministic—even when they touch the outside world.
import asyncio
import random
from pathlib import Path
import duron
from duron.contrib.storage import FileLogStorage
# Effects encapsulate side effects (I/O, randomness, API calls)
@duron.effect
async def work(name: str) -> str:
print("⚡ Preparing to greet...")
await asyncio.sleep(2)
print("⚡ Greeting...")
return f"Hello, {name}!"
@duron.effect
async def generate_lucky_number() -> int:
print("⚡ Generating lucky number...")
await asyncio.sleep(1)
return random.randint(1, 100)
# Durable functions orchestrate workflow logic via ctx.run()
# They're deterministically replayed from logs on resume
@duron.durable
async def greeting_flow(ctx: duron.Context, name: str) -> str:
# Run effects concurrently - results are logged for replay
message, lucky_number = await asyncio.gather(
ctx.run(work, name),
ctx.run(generate_lucky_number),
)
return f"{message} Your lucky number is {lucky_number}."
async def main():
# Session manages execution and log storage
async with duron.Session(FileLogStorage(Path("log.jsonl"))) as session:
# Starts new workflow or resumes from existing log
task = await session.start(greeting_flow, "Alice")
result = await task.result()
print(result)
if __name__ == "__main__":
asyncio.run(main())
Next steps
- Read the getting started guide
- Explore a more advanced example with streams and signals: examples/agent.py
Metadata
Release files for duron 0.0.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| duron-0.0.3.tar.gz | 29.3 kB | Without provenance | Details for duron-0.0.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| duron-0.0.3-py3-none-any.whl | Python 3 | none | any | Details for duron-0.0.3-py3-none-any.whl |
Total release size: 70.2 kB
Release files / duron-0.0.3.tar.gz
| Download URL | duron-0.0.3.tar.gz |
|---|---|
| Size | 29.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
39696fec290b65778ee4eb558f357ccd3f0c061b7c36e2cebee51d229fc9556d
|
|
BLAKE2b-256 checksum How to use checksums |
a08ee738730c7be8490c5fb42b80da087f8064728f5dde1a036c09dd783fd95d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.9.7
|
Release files / duron-0.0.3-py3-none-any.whl
| Download URL | duron-0.0.3-py3-none-any.whl |
|---|---|
| Size | 40.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e9c94b609cc648d3f355911205a02dd6561ed7a43accd2fe6ee32f8286ca2a8e
|
|
BLAKE2b-256 checksum How to use checksums |
1d93f4d4644d342715607051e54ab3b064f5e6ed4ebe1c32cddbd81eb5babb57
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.9.7
|
Security for duron 0.0.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.