Metadata-Version: 2.4
Name: forge-worker-sdk
Version: 0.0.12
Summary: Organizyio Forge — Python worker IPC SDK (framing, server runtime, job registry, dispatcher).
Author-email: Organizyio <opensource@organizy.io>
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/organizyio/forge
Project-URL: Repository, https://github.com/organizyio/forge
Project-URL: Documentation, https://github.com/organizyio/forge/blob/main/docs/python-worker.md
Project-URL: Changelog, https://github.com/organizyio/forge/blob/main/CHANGELOG.md
Keywords: forge,ipc,worker,msgpack,organizy
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries
Classifier: Typing :: Typed
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: msgpack>=1.0.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"

# forge-worker-sdk (Python)

Python peer of the Rust `forge-worker-sdk` crate. Speaks Forge framed IPC over Unix domain sockets or framed stdio.

## Install

```bash
pip install forge-worker-sdk
# or
uv add forge-worker-sdk
```

From source (contrib / tests):

```bash
cd forge/python
python3 -m pip install -e ".[dev]"
FORGE_WORKER_TEST=1 pytest
```

## Example worker

```bash
python3 examples/minimal-python-worker/main.py --socket /tmp/forge-py.sock --encoding json
```

See [docs/python-worker.md](../docs/python-worker.md).
