Metadata-Version: 2.4
Name: harnessgg-blender
Version: 0.1.0
Summary: Bridge-first CLI for Blender automation
Author: Harness
License: MIT
Project-URL: Homepage, https://github.com/harnessgg/harness-blender
Project-URL: Repository, https://github.com/harnessgg/harness-blender
Project-URL: Documentation, https://github.com/harnessgg/harness-blender/tree/main/docs
Project-URL: Issues, https://github.com/harnessgg/harness-blender/issues
Keywords: blender,3d,automation,ai-agent,cli
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
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
Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer>=0.12.3
Provides-Extra: dev
Requires-Dist: build>=1.2.1; extra == "dev"
Requires-Dist: pytest>=8.3.0; extra == "dev"
Requires-Dist: ruff>=0.8.0; extra == "dev"
Requires-Dist: twine>=5.1.1; extra == "dev"
Dynamic: license-file

# harness-blender

Bridge-first Python package for agent-driven Blender automation through a JSON CLI.

## Install (local)

```bash
pip install -e .
```

## Quick Start

```bash
harness-blender bridge start
harness-blender doctor
harness-blender file new scene.blend --overwrite
harness-blender object add scene.blend CUBE --name CubeA
harness-blender camera add scene.blend --name CamMain
harness-blender camera set-active scene.blend CamMain
harness-blender render still scene.blend out.png
```

## Docs

- Human commands: `docs/human/commands.md`
- LLM command spec: `docs/llm/command-spec.md`
- Bridge protocol: `docs/llm/bridge-protocol.md`
- Error codes: `docs/llm/error-codes.md`
- Response schema: `docs/llm/response-schema.json`

## Publishing

Build and validate locally:

```bash
python -m pip install -e ".[dev]"
python -m build
twine check dist/*
```

Automated publish is configured in `.github/workflows/publish.yaml` using trusted publishing
(`environment: pypi` + OIDC).
