langgraph-events
Opinionated event-driven abstraction for LangGraph. State IS events.
[!CAUTION] Experimental (v0.23.1) - This is an early-stage personal project, not a supported product. The API will change without notice or migration path.
Quick Start
Group related commands and events into a Namespace; colocate the handler on the command.
from langgraph_events import Command, DomainEvent, EventGraph, Namespace
class Order(Namespace):
class Place(Command):
customer_id: str
class Placed(DomainEvent):
order_id: str
def handle(self) -> Placed:
return Order.Place.Placed(order_id=f"o-{self.customer_id}")
graph = EventGraph([Order.Place])
log = graph.invoke(Order.Place(customer_id="alice"))
print(log.latest(Order.Place.Placed))
@on(...) handlers add invariants, declared exceptions, and cross-namespace reactions. See Concepts and Control Flow.
Installation
pip install langgraph-events
# With AG-UI adapter support
pip install "langgraph-events[agui]"
# From source (development)
pip install git+https://github.com/cadance-io/langgraph-events.git
Documentation
- Docs site (GitHub Pages): https://cadance-io.github.io/langgraph-events/
- Local docs index:
docs/index.md - Getting started:
docs/getting-started.md - Core concepts:
docs/concepts.md - Patterns:
docs/patterns.md - Reflection (agent-queryable event log):
docs/reflection.md - API reference:
docs/api.md - AG-UI adapter:
docs/agui.md - Checkpointer and graph evolution:
docs/checkpointer-evolution.md
Development
uv sync --group dev
uv run pytest tests/
uv run ruff check src/ tests/
uv run mypy src/
License
MIT - see LICENSE.
1 maintainer
Metadata
1 maintainer
Release files for langgraph-events 0.23.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| langgraph_events-0.23.1.tar.gz | 496.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| langgraph_events-0.23.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 642.4 kB
Release files / langgraph_events-0.23.1.tar.gz
| Download URL | langgraph_events-0.23.1.tar.gz |
|---|---|
| Size | 496.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3150303f27a8f40376b2af3a47963b6291190628506deb24b2bdfbe64fc381f7
|
|
BLAKE2b-256 checksum How to use checksums |
9e43d4f76a82c13bd67090533cfed4ccbce723d8f03fcb4002086429095ee945
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / langgraph_events-0.23.1-py3-none-any.whl
| Download URL | langgraph_events-0.23.1-py3-none-any.whl |
|---|---|
| Size | 145.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
970b08a06fd81c97cfa287b51477b502d60df69d7f5988dd3cbe87d067d4bb54
|
|
BLAKE2b-256 checksum How to use checksums |
a4a084de62b1cb1460ac83e339346152ccc01c0eeda85561dcd8b4e9504ddc8a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
