Metadata-Version: 2.4
Name: visualfactory
Version: 1.0.0
Summary: Official Python SDK for Visual Factory image automation API
Author: Visual Factory
License: SEE LICENSE IN LICENSE.md
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.31.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"

# visualfactory-python

Official Python SDK for [Visual Factory](https://github.com/your-org/visual-factory).

## Install

```bash
pip install visualfactory-python
# or from monorepo:
pip install ./packages/python-sdk
```

## Quick start

```python
from visualfactory import VisualFactory

vf = VisualFactory("vf_live_your_api_key", base_url="https://factory.example.com")

# One-liner — enqueue + poll
result = vf.images.remove_background("./shoe.jpg")
print(result["status"], result.get("result", {}).get("imageSrc", "")[:80])

# Webhook registration
vf.create_webhook("https://firma.com/api/vf-callback", events=["job.completed", "job.failed"])
```

## Parity with Node SDK

| Node (`@visualfactory/node`) | Python |
|------------------------------|--------|
| `new VisualFactory(apiKey)` | `VisualFactory(api_key)` |
| `vf.images.removeBackground(file)` | `vf.images.remove_background(path)` |
| `vf.createWebhookSubscription(...)` | `vf.create_webhook(...)` |
| `vf.pollJob(id)` | `vf.poll_job(id)` |
