ASTERIONBefore you begin
Fedora KDE is the documented starting environment. These application screens were captured on Fedora 44 with Python 3.14 and Qt 6.11. Other Linux distributions, Windows and macOS have not been verified for this guide.
You need a graphical desktop, Python 3, PyQt6 and permission to install Fedora packages. Internet access is needed to obtain dependencies. Ollama is optional.
1. Put the application in a permanent folder
Extract your supplied copy into ~/Applications/Asterion-Linux. That folder should contain run.sh, install.sh and asterion_app/. Open a terminal and run:
cd "$HOME/Applications/Asterion-Linux"
ls run.sh asterion_app/app.pySuccess: Both filenames are listed. If the folder has another name, use its real location in the cd command.
2. Install the Python bindings
Run these commands in your terminal. sudo asks for an administrator password to install Fedora packages.
sudo dnf install python3 python3-pyqt6
python3 -c "from PyQt6.QtWidgets import QApplication; print('PyQt6 is ready')"Success: The import prints “PyQt6 is ready”. The package name is confirmed by Fedora Packages. The guide uses system Python because run.sh calls python3 from your current PATH.
3. Launch Asterion
cd "$HOME/Applications/Asterion-Linux"
bash ./run.shSuccess: A splash screen leads to Command Centre. Keep the terminal open while checking your first launch so you can read any errors. The supplied install.sh only adds a launcher and icon; it is not a dependency installer.
4. Add a shortcut for your actual folder
The bundled desktop entry uses a developer-specific absolute path. Use the small launcher helper below from the application folder to generate an entry for your own location. It does not move the app or change its code.
Download create-launcher.py, save it to Downloads, then run:
cd "$HOME/Applications/Asterion-Linux"
python3 "$HOME/Downloads/create-launcher.py"Success: The helper prints the new desktop-entry path. Search for Asterion in the KDE application menu. If the entry has not appeared, sign out and back in. If you later move the app folder, rerun this helper from its new location.
Updates and removal
- Close Asterion and make a complete backup.
- Obtain an updated application folder from your verified supplier. Preserve your previous folder until the new copy launches and your data looks correct. Follow any release-specific migration instructions supplied with it.
- If its location changes, rerun the launcher helper from the new application folder.
- To remove the supplied menu entry and icon, run
bash ./uninstall.shfrom the application folder. The current script leaves the application folder and all user data intact. If you customised XDG locations, remove the helper’s printed desktop-entry path manually instead. - After keeping a backup, remove the application folder using your file manager if you no longer want it. Delete user data only if you intend to erase your records; see Privacy and data for paths.
When installation does not work
| Symptom | Check and remedy |
|---|---|
| No module named PyQt6 | Run the import check in step 2 using the same terminal. Install python3-pyqt6 for system Python. A package installed in a different virtual environment is not automatically available to the launcher. |
| Permission denied | Use bash ./run.sh from the extracted application folder. Keep the folder readable by your user and outside protected system directories. Do not run Asterion as root. |
| No application menu entry | Launch from the terminal first. Rerun the helper from the correct folder and sign out/in if KDE has not refreshed. |
| Shortcut fails after moving the folder | Regenerate the shortcut in its new location. Desktop entries store an absolute path. |
| Qt platform plugin error | Confirm you are in a working graphical desktop session and that Fedora PyQt6 packages are installed. Read the terminal error before changing Qt environment variables. |
Then continue to your first session.