Metadata-Version: 2.4
Name: klock
Version: 0.1.3
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Rust
Classifier: Topic :: Software Development :: Libraries
License-File: LICENSE
Summary: Native Rust-powered coordination kernel for multi-agent systems
Keywords: klock,coordination,agents,concurrency,rust
Home-Page: https://klockcore.com
Author-email: Mouad Nossair <mouad@waythor.com>, Walid Amar <walid@waythor.com>
License: MIT
Requires-Python: >=3.8
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: homepage, https://klockcore.com
Project-URL: repository, https://github.com/waythor-lab/klock

# klock

Python SDK for Klock OSS v1.

Use the high-level facade first:

```python
from klock import Klock

klock = Klock.local(agent_id="agent-a")

with klock.file("/src/auth.js", mode="mutate"):
    # read/write safely
    ...
```

`Klock.local(...)` coordinates through the local Klock server under the hood and auto-starts it on the first lock operation for localhost workflows. Use `Klock.embedded(...)` only when all coordinated work happens inside one process.

Advanced clients are still available:

- `KlockClient` for embedded low-level coordination
- `KlockHttpClient` for direct HTTP coordinator access

