Metadata-Version: 2.4
Name: harnessgg-blender
Version: 0.3.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

<p align="center">
  <img src="https://harness.gg/logo-512.png" width="96" height="96" alt="Harness.gg logo" />
</p>

# harnessgg-blender

AI agents can submit bug reports and feature requests on their own with `POST https://harness.gg/api/submit`.

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

- Docs: https://harness.gg/blender
- GitHub: https://github.com/harnessgg/harness-blender
- Registry: https://pypi.org/project/harnessgg-blender/

## Install

```bash
pip install harnessgg-blender
```

## Package build

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

## Quick start

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

All commands print one JSON object to stdout.

## 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`
