Metadata-Version: 2.4
Name: mirrorneuron-python-sdk
Version: 1.2.18
Summary: MirrorNeuron Python SDK
License-Expression: MIT
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: grpcio>=1.50.0
Requires-Dist: protobuf>=4.21.0
Provides-Extra: dev
Requires-Dist: build>=1.0; extra == "dev"
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: ruff>=0.8; extra == "dev"
Requires-Dist: twine>=5.0; extra == "dev"
Dynamic: license-file

# MirrorNeuron Python SDK

`mn-python-sdk` provides the Python gRPC client and workflow-bundle helpers used
by the CLI, API, and Python-defined workflows.

## Quick Start

Install locally and run tests:

```bash
python3.11 -m venv .venv
. .venv/bin/activate
.venv/bin/python -m pip install -e ".[dev]"
.venv/bin/python -m pytest -q
.venv/bin/python -m ruff check .
```

Minimal client example:

```python
from mn_sdk import Client

client = Client(target="localhost:55051")
print(client.list_jobs(limit=5))
```

## Details

- [MirrorNeuron Component Guide](../mn-docs/component-guide.md#python-sdk)
- [Python SDK](../mn-docs/SDK.md)
- [Job Bundle Format](../mn-docs/bundle.md)
- [Environment Variables](../mn-docs/env_variables.md)

## Notes

- A running MirrorNeuron core is required for live client calls.
- Constructor arguments take precedence over environment variables.
- Generated protocol modules are included with the package.
