Getting Started with NexTructures
Comprehensive documentation for installing, configuring, and executing your first structural detailing project.
1. Installation
Begin by downloading the official installer from our release repository.
- Download
Nextructures_2026_Setup.exefrom the Download page. - Execute the installer with administrative privileges.
- Follow the setup wizard to unpack application files to your target directory.
System Requirements Reference:
- Windows 10 or 11 (64-bit)
- Python 3.11 environment (if running from source)
- OpenGL 3.3 compatible graphics card
- MySQL 8.0 server (local or remote)
- Minimum 8GB RAM (16GB recommended for large assemblies)
2. Launching NexTructures
You can initialize the core application via the command line interface or standard batch scripts.
To start the primary graphical interface:
py NexTructures.py
Alternatively, execute the provided batch script by double-clicking NexTructures.bat.
Command Line Interface Reference
The openbim_cli.py utility provides direct access to individual subsystems:
py openbim_cli.py gui
py openbim_cli.py 3d
py openbim_cli.py canvas
py openbim_cli.py drawing-manager
3. Your First Project
Follow these steps to establish a new structural model:
- Launch NexTructures and select New Project from the start screen.
- Configure the project metadata and select the target MySQL database schema.
- Utilize the Steel Profile Catalog dock to select initial members (e.g., W-Shapes or HEB).
- Define grids in the 3D viewport and begin placing columns and beams.
- Apply parametric connections from the Connection Library (e.g., Baseplates, Shear Tabs).
4. Importing IFC Models
NexTructures supports robust Open BIM workflows utilizing the native IfcOpenShell engine.
- Navigate to File > Import > IFC Model.
- Select a valid IFC4 or IFC4x3 file.
- Specify the insertion point and orientation vector.
- The engine will parse the geometry into OpenBIM JSON format and overlay the reference model onto your structural workspace.
5. Tekla Structures Integration
The native C# .NET bridge enables bidirectional model extraction targeting Tekla Structures 2022.
- Ensure Tekla Structures 2022 is installed and running on the target machine.
- In NexTructures, navigate to the Bridge Configuration panel.
- Confirm the path to
Tekla.Structures.Model.dllis resolved. - Use the bridge tools to import existing Tekla 2022 model directories or execute synchronized macro plugins.
6. Database Configuration
All model persistence requires an active MySQL connection.
- Host: localhost:3306
- Username: root
- Password: Free12345
- Schema: openbim_db
The software will attempt to build the elements and transactions table schemas automatically upon the first successful connection.
7. Running Tests
For developers modifying the source repository, ensure continuous integration integrity by executing the test suite.
py -m pytest
The current suite contains 37 passing assertions validating core engine functionality.