Installation - Requirements¶
Python¶
Python 3.11 or newer must be installed before installing Cecilia. You can download Python from https://www.python.org/downloads/.
Cecilia is compatible with the following systems:
MacOS
Windows
Linux
Install with pip¶
Install Cecilia from PyPI using the command for your operating system.
Replace 3.14 with the Python version installed on your system.
Windows:
py -3.14 -m pip install -U cecilia
Linux/macOS:
python3.14 -m pip install -U cecilia
Then run it:
cecilia
Desktop registration¶
On Linux, Windows or macOS, register Cecilia in your application menu by running once after installation:
cecilia-register-desktop
On Linux, this creates ~/.local/share/applications/cecilia.desktop for your
user. On Windows, it creates a Cecilia5 shortcut in your Start menu using
Windows PowerShell. The shortcut launches Cecilia without a console window.
On macOS, this creates a lightweight ~/Applications/Cecilia5.app launcher
with the Cecilia icon, which you can open in Finder or drag to the Dock. It uses
the current Python installation without opening Terminal. Registration refreshes
an existing launcher but refuses to overwrite a standalone application.
If you installed Cecilia in a virtual environment, run the command from that environment and keep it installed for the menu entry to work. Run the command again if you move or reinstall Cecilia in a different environment.
The macOS launcher uses the built-in osacompile and codesign tools to
create a locally ad hoc signed applet; it is not Developer ID signed or notarized.
It includes a microphone usage description, but audio input still requires your
permission in System Settings > Privacy & Security > Microphone. Permission
attribution and persistence depend on your Python installation; this launcher
does not provide the signing or entitlement guarantees of a standalone app.
Running Cecilia from the latest sources¶
Before running Cecilia from the latest sources, install its dependencies using
the command for your operating system. Replace 3.14 with the Python version
installed on your system in both the installation and launch commands below.
Windows:
py -3.14 -m pip install -U pyo wxPython numpy
Linux/macOS:
python3.14 -m pip install -U pyo wxPython numpy
Then, you can download Cecilia’s sources by checking out the source code (in a terminal window):
git clone https://github.com/belangeo/cecilia5.git
This will create a folder named “cecilia5” with the source code. Go inside the folder and run Cecilia using the same Python version as above.
Windows:
cd cecilia5
py -3.14 Cecilia5.py
Linux/macOS:
cd cecilia5
python3.14 Cecilia5.py