Skip to content

Releases: q9scotty/blender-ai-agent

Blender AI Agent 0.2.1 beta 5

Pre-release

Choose a tag to compare

@q9scotty q9scotty released this 21 Jul 21:00

Blender AI Agent 0.2.1 beta 5

Artifact

  • Source tag: v0.2.1-beta.5
  • File: dist/blender_ai_agent-0.2.1-beta.5.zip
  • Manifest version: 0.2.1
  • Size: 51,106 bytes
  • SHA-256: b66366dbd14d4690f1bcf1b6c71b29caece3fc495beccdbe64fc83216188e404
  • Verified Blender: 5.2.0 LTS, build fbe6228777e7
  • Verified OS: Ubuntu 24.04.2 LTS, x86_64, GNOME on Wayland
  • Add-on runtime: Blender-bundled Python 3.13.13
  • Unit-test runtime: Ubuntu system Python 3.12.3

The dist/ directory is intentionally ignored by Git. Rebuild the artifact
from the tagged or committed source with scripts/build_beta.sh, then compare
its printed checksum with this record.

Installation

Install the ZIP without extracting it through Blender's Edit → Preferences →
Extensions → Install from Disk…
workflow, enable Blender AI Agent, then
open the 3D Viewport sidebar's AI Agent tab and click Start Local Server.

See docs/installation.md for the complete first agent connection, smoke test,
shutdown, and troubleshooting flow.

This Build Week beta claims support only for the measured environment in
docs/verified-environment.md. Other platforms and versions are untested, not
implicitly supported by these verification results.

Automated package acceptance

scripts/verify_beta_package.sh performed the following in a fresh temporary
Blender profile:

  1. Validated the built ZIP with Blender 5.2.
  2. Confirmed the reference POC is absent from the archive.
  3. Installed the ZIP into the isolated user_default extension repository.
  4. Confirmed the add-on was initially disabled.
  5. Enabled it and verified the loaded module came from the installed repository,
    not the working tree.
  6. Confirmed the sidebar and lifecycle operators registered.
  7. Confirmed a fresh install defaults to port 18765, simulated the prior
    beta's persisted 8765 setting, and verified the installed extension
    migrates it to 18765 on registration. It then started the loopback service
    on an isolated test port, checked /health and /help, and verified the
    automatic export directory stayed inside the isolated profile.
  8. Stopped and disabled the extension, then re-enabled and saved preferences.
  9. Restarted Blender, confirmed enablement persisted, and repeated start/stop.
  10. Disabled it, restarted Blender again, and confirmed it remained disabled.

The automated test uses Blender's package installer and real persisted Blender
preferences. It does not claim that a new human tester has clicked through the
Preferences UI or evaluated the written instructions yet.

Beta boundaries

  • The service starts only after an explicit user action and binds to loopback.
  • Blender must remain open and visible during normal agent work.
  • 3D Print Toolbox is an optional, separate extension and is not bundled.
  • Geometry checks and Boolean preflight warnings are evidence, not print
    guarantees.
  • Save important Blender files before beta testing.
  • Final licensing/security review, representative stamp acceptance, and the
    interactive install-from-disk walkthrough remain open roadmap items.