Bonsai Core Architecture

Version: Bonsai v0.8.4 | Blender 4.2.0+ | Python 3.11 Module path: bonsai.* — NEVER blenderbim.* Repository: IfcOpenShell/IfcOpenShell monorepo → src/bonsai/

Critical Warnings

1. ALWAYS use bonsai.* imports. NEVER use blenderbim.* — renamed in 2024 (v0.8.0+).
2. ALWAYS check IfcStore.get_file() for None before any IFC operation.
3. NEVER describe Bonsai workflow as "import/export". The IFC file IS the document.
4. ALWAYS run Bonsai scripts via blender --python. NEVER import bonsai.* from system Python.
5. ALWAYS call bpy.ops.bim.edit_object_placement() after direct matrix/location changes.
6. ALWAYS use ifcopenshell.api.run() for IFC mutations, NEVER modify entity attributes directly.
7. NEVER use void.add_opening() — use feature.add_feature() (changed in v0.8.0+).

Three-Layer Architecture