Bonsai Project Management

Version: Bonsai v0.8.x | IfcOpenShell v0.8.x | IFC2X3 / IFC4 / IFC4X3 Dependency: bonsai-core-architecture (MUST read first) Module path: bonsai.* — NEVER blenderbim.*

Critical Warnings

1. ALWAYS use ifcopenshell.api.project.create_file() to create new IFC projects. NEVER use ifcopenshell.file() directly — it skips required project setup (IfcProject, IfcUnitAssignment, representation contexts).
2. ALWAYS set units via ifcopenshell.api.unit.assign_unit() immediately after project creation. An IFC file without a unit assignment is invalid per all IFC schemas.
3. NEVER describe the Bonsai workflow as "import/export". The IFC file IS the native document.
4. ALWAYS use bonsai.* imports. NEVER use blenderbim.* — renamed in 2024 (v0.8.0+).
5. ALWAYS check IfcStore.get_file() for None before any IFC operation.
6. ALWAYS call ifcopenshell.api.georeference.add_georeferencing() before edit_georeferencing(). Editing non-existent entities raises an error.
7. NEVER set Eastings/Northings without confirmed survey data. Wrong values place the building at the wrong location on Earth.
8. ALWAYS run scripts via blender --python. NEVER import bonsai.* from system Python.

Schema Selection Decision Tree