Python bindings for Loro CRDT. If you have any issues or suggestions, please feel free to create an issue or join our Discord community.
- High-performance CRDT operations with Rust implementation
- Rich data types support: Text, List, Map, Tree, Movable List, Counter
- Python-friendly API design
pip install lorofrom loro import LoroDoc
# Create a new document
doc = LoroDoc()
# Get a text container
text = doc.get_text("text")
# Insert text
text.insert(0, "Hello, Loro!")
# store the `subscription` reference to prevent garbage collection
sub = doc.subscribe_root(lambda e: print(e))
doc.commit()- Python 3.8+
- Rust toolchain
- maturin
- Clone the repository
git clone https://github.com/loro-dev/loro-py
cd loro-py- Install development dependencies and run
# choose your python venv
pip install maturin
maturin developUses Loro core 1.18.0, including its import validation, undo and text correctness fixes and performance improvements. Existing Python APIs and supported platform matrix are retained.
Uses Loro core 1.17.1. Adds LoroDoc.export_pending_updates() to persist received
updates waiting for missing dependencies alongside a consistent snapshot. Restore
the snapshot first, then import the pending bytes. None means nothing is pending;
clear any previously saved pending bytes when replacing a checkpoint with None.
JSON export keeps returning the existing JSON string and reports history decode
failures as Python exceptions. The state_vv property retains its existing type.