Installation & Setup

Follow these steps to deploy Fyskode Chaotic Systems Toolbox on your local workstation. Choose between precompiled standalone releases (when available) or running directly from the source repository.

Desktop Installers (v0.1.0)

Pre-packaged standalone executables for direct desktop deployment. No Python environment required.

⚠️

Notice: The official desktop installer is pending publication on the GitHub Releases page. In the meantime, please build or run the software directly from the source code.

Windows (x64) · pending macOS (Intel/Silicon) · pending Linux (AppImage) · pending

Run from Source

Clone the repository and run the application using a Python 3.10+ environment.

Core Dependencies

PyQt6: Handles the graphical desktop interface.
NumPy: Drives numerical simulation arrays.
Matplotlib: Renders high-quality 2D/3D attractor figures.

# Clone the repository
git clone https://github.com/Xerkkun/Toolbox-chaos.git
cd Toolbox-chaos

# Install dependencies
pip install -r requirements.txt

# Launch the GUI application
python main.py

View Code on GitHub

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.