Metadata-Version: 2.5
Name: agsb3d
Version: 0.1.0a1
Summary: Local-first MCP platform that turns AI briefs into validated, editable 3D assets through tested Blender workflows.
Project-URL: Homepage, https://github.com/saferbayram/agsb3d
Project-URL: Documentation, https://github.com/saferbayram/agsb3d/tree/main/docs
Project-URL: Issues, https://github.com/saferbayram/agsb3d/issues
Project-URL: Changelog, https://github.com/saferbayram/agsb3d/blob/main/CHANGELOG.md
Author: Safer Bayram
License-Expression: Apache-2.0 AND GPL-3.0-or-later
License-File: LICENSE
License-File: LICENSES/GPL-3.0-or-later.txt
License-File: src/agsb3d/adapters/blender/runtime/LICENSE
Keywords: 3d,ai-agents,asset-pipeline,blender,mcp,procedural
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
Requires-Python: >=3.12
Requires-Dist: mcp<3,>=2.3
Requires-Dist: pydantic<3,>=2.12
Description-Content-Type: text/markdown

# AGSB3D

**Validated, editable 3D assets from AI briefs, through tested Blender workflows instead of model-written scripts.**

AGSB3D is a local-first MCP server and CLI. An AI client, or you, writes a structured brief: what to make, its size, its budgets, the deliverables, and optionally a motion or a scene. AGSB3D then does the rest:

1. It compiles the brief into a hash-bound plan.
2. It runs reviewed Blender operations in a supervised background worker.
3. It measures every result in a fresh process: geometry, dimensions, pivot, budgets, UVs, textures, an independent GLB parse, axis conversion, reimport, and, for animation, every frame.
4. It optionally verifies the asset inside Unreal Engine or Unity.
5. It publishes a delivery bundle whose manifest says exactly which checks passed and which did not.

Passing gates proves the measured checks, nothing more. It is not a claim of professional artistic quality.

## What it makes

| Skill | Makes | Verified in |
|---|---|---|
| `procedural-tree` | Naturalistic oak with leaf cards, PBR textures, and design candidates | Blender, Unreal, Unity |
| `procedural-barrel` | Headed wooden cask with iron hoops | Blender, Unreal, Unity |
| `procedural-rock` | Boulder with baked, seamless stone and lichen | Blender, Unreal, Unity |
| `procedural-ground` | Ground patch with a level clearing and a path | Blender, Unreal, Unity |
| `woodland-clearing` | A scene of instanced oaks and rocks with goal cameras and a scene budget | Blender, Unity |
| `hinged-door` | A door with editable swing clips, measured frame by frame and played back in Unity | Blender, Unity |
| `asset-repair` | Repairs of an existing `.blend` prop, with checkpoints and rollback | Blender |
| `diagnostic-axis-fixture` | An axis and scale marker for interchange checks | Blender, Unreal, Unity |

## Install

Requirements: Windows 11 x64, Python 3.12 or later, and Blender 5.2.1 LTS. Unreal Engine 5.8.2 and Unity 6000.3.27f1 are optional, for engine verification.

```powershell
python -m pip install agsb3d
agsb3d doctor
```

Use it from an MCP client, for example Claude Code:

```powershell
claude mcp add agsb3d -- agsb3d mcp serve
```

## Status

This is an alpha release (`0.1.0a1`). Known limits:

- Windows only.
- One verified build per application.
- Visual reviews so far were done by an AI reviewer, not by people.
- Animation covers one rigid subject.

The documentation, architecture, decisions, compatibility matrix, and the evidence behind every claim are in the project repository: https://github.com/saferbayram/agsb3d

## License

Apache-2.0 AND GPL-3.0-or-later. The code that runs inside Blender is GPL-3.0-or-later because it uses Blender's Python API; everything else is Apache-2.0.
