Installation & Setup

Download a desktop installer for direct use or run the application from its source repository when you need to extend the code.

Desktop installer (v0.1.0)

This is the recommended route for research teams. 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 does not require a separate Python installation.

Windows: download the windows-x64-setup.exe file 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 PyQt6, 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

Common Issues & Troubleshooting

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

Ensure you do not have conflicting plotting backends configured in your global matplotlibrc. Fyskode Chaos Toolbox defaults to using QtAgg for integration within the PyQt6 GUI framework.