Metadata-Version: 2.4
Name: mrmd-python
Version: 0.1.0
Summary: Python runtime server implementing the MRMD Runtime Protocol (MRP)
Author: mrmd contributors
License: MIT
Keywords: ipython,mrmd,mrp,notebook,runtime
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Requires-Dist: black>=25.12.0
Requires-Dist: ipython>=8.0.0
Requires-Dist: jedi>=0.19.0
Requires-Dist: sse-starlette>=2.0.0
Requires-Dist: starlette>=0.40.0
Requires-Dist: uvicorn>=0.32.0
Provides-Extra: dev
Requires-Dist: httpx>=0.27.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Provides-Extra: format
Requires-Dist: black>=24.0.0; extra == 'format'
Description-Content-Type: text/markdown

# mrmd-python

Python runtime server implementing the MRMD Runtime Protocol (MRP).

## Installation

```bash
uv pip install mrmd-python
```

## Usage

### Command Line

```bash
mrmd-python --port 8000
```

### Programmatic

```python
from mrmd_python import create_app
import uvicorn

app = create_app(cwd="/path/to/project")
uvicorn.run(app, host="localhost", port=8000)
```

## API Endpoints

All endpoints are prefixed with `/mrp/v1/`.

| Endpoint | Method | Purpose |
|----------|--------|---------|
| `/capabilities` | GET | Runtime capabilities |
| `/sessions` | GET/POST | List/create sessions |
| `/execute` | POST | Run code |
| `/execute/stream` | POST | Run code with SSE streaming |
| `/complete` | POST | Get completions |
| `/inspect` | POST | Get symbol info |
| `/hover` | POST | Get hover tooltip |
| `/variables` | POST | List variables |
| `/interrupt` | POST | Cancel execution |

## Protocol

See [PROTOCOL.md](../mrmd-editor/PROTOCOL.md) for the full MRP specification.
