Metadata-Version: 2.4
Name: machgen-client
Version: 0.1.0
Summary: External client for the MachGen platform - submit tasks via the public API.
Author: MachGen
License-Expression: Apache-2.0
Project-URL: Homepage, https://www.machgen.ai
Project-URL: Documentation, https://www.machgen.ai/docs
Project-URL: Repository, https://github.com/MachGen/machgen-client
Project-URL: Issues, https://github.com/MachGen/machgen-client/issues
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pydantic>=2.12.5
Requires-Dist: httpx>=0.28.0
Requires-Dist: httpx-sse>=0.4.0
Dynamic: license-file

# machgen-client

External Python client for the MachGen platform.

## Installation

```bash
pip install machgen-client
```

Requires Python 3.11 or newer.

To install the latest source snapshot for development:

```bash
pip install "git+https://github.com/MachGen/machgen-client.git"
```

## Quick Start

Check the [docs](https://www.machgen.ai/docs/`) on how authentication
works and get an API key from there.

Populate the API key either in env var `MACHGEN_API_KEY`
or set it when creating the client `MachGenClient(api_key="...")`.

```python
from machgen.client import MachGenClient, TaskInput, TaskOutputType, VideoConfig

with MachGenClient() as client:
    handle = client.submit_task(
        TaskInput(
            prompt="...",
            model="Wan2.2-T2V-A14B",
            task_type="T2V",
            video_config=VideoConfig(duration_secs=5, height=720, width=1280, fps=16),
        )
    )
    result = client.wait(handle)
    print(result.task_output[TaskOutputType.VIDEO])
```

## Documentation

Full docs are published at https://www.machgen.ai/docs.

Runnable scripts for each task type live in the
[examples directory](https://github.com/MachGen/machgen-client/tree/main/examples).
