Install and launch Toolbox Chaos

Use the desktop installer for standard use, or run the application from its source repository when your work includes code extensions.

Desktop installer (v0.1.0)

For research workstations, open the Releases page, choose the package for your operating system, run the installer, and launch Toolbox Chaos from the application menu. The standalone package includes its own Python runtime.

Windows: download the file named with the pattern chaos-toolbox-v[version]-windows-x64-setup.exe and double-click it.
macOS: download the package matching Intel or Apple Silicon and move the app to Applications.
Linux: download the x64 AppImage, make it executable, and open it.

Open official downloads

Run or extend from source

Use this route when you want to inspect the implementation, add a registered model, or build a research-specific interface. It requires Python 3.10 or newer.

git clone https://github.com/Xerkkun/Toolbox-chaos.git
cd Toolbox-chaos
python -m pip install -r requirements.txt
python main.py

The interface depends on PySide6, NumPy, Matplotlib, pyqtgraph, and PyYAML. General numerical capabilities belong in the Hidden Attractors FO engine and are exposed to the GUI through a narrow adapter.

View source repository

Platform setup and launch issues

1. PyQt6 dependency fails to build on Linux

Some Linux installations require system-level packages for Qt libraries before PyQt6 can be compiled/installed. Run sudo apt install libxcb-cursor0 or the equivalent package manager command for your distribution.

2. Matplotlib window crashes on launch

Configure one plotting backend in your global matplotlibrc. Toolbox Chaos uses QtAgg for integration with the PyQt6 GUI framework.