Metadata-Version: 2.4
Name: markitdownapi-sdk
Version: 0.2.0
Summary: Python gRPC SDK for MarkItDown microservice — MarkItDown, Storage, Pipeline, and message schemas
Project-URL: Homepage, https://github.com/microsoft/markitdown
Project-URL: Repository, https://github.com/microsoft/markitdown
Author: MarkItDown gRPC Team
License-Expression: MIT
Keywords: document-conversion,grpc,markitdown,protobuf
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: grpcio>=1.60
Requires-Dist: protobuf<7.0,>=5.0
Description-Content-Type: text/markdown

# markitdownapi-sdk

Python gRPC SDK for MarkItDown microservice.

## Services

| Proto | Service | Description |
|-------|---------|-------------|
| `markitdown.proto` | `MarkItDownService` | Document/URL to Markdown conversion |
| `storage.proto` | `StorageService` | MinIO object storage (SaveObject / GetObject) |
| `pipeline.proto` | `PipelineService` | Pipeline runtime status |
| `input.proto` | — | Upstream message schemas (DocConvertMessage) |
| `output.proto` | — | Downstream notification schemas (DocConvertNotification) |

## Install

```bash
pip install markitdownapi-sdk
```

## Usage

```python
import grpc
from markitdownapi.v1.markitdown_pb2 import ConvertURLRequest
from markitdownapi.v1.markitdown_pb2_grpc import MarkItDownServiceStub

channel = grpc.insecure_channel("localhost:9091")
stub = MarkItDownServiceStub(channel)
resp = stub.ConvertURL(ConvertURLRequest(url="https://example.com"))
print(resp.markdown)
```

## Regenerate

```bash
buf generate  # requires buf CLI
```
