PyFCS is publicly available as open-source software on GitHub:

https://github.com/RafaelConejo/PyFCS

The repository provides access to the full source code, demonstration materials, and additional utility files.

System Requirements

Before installing PyFCS, ensure that a Python environment is properly configured.

• Python 3.9 or higher (Python 3.10 recommended)
• The commands python and pip must be available from the command line
• A virtual environment manager (e.g., venv or Anaconda) is recommended but not required

If the pip command is not available, it can be installed using:

python -m ensurepip --upgrade

More information is available at:
https://pip.pypa.io/en/stable/installation/

Installation

Windows

1. Download the project from GitHub using the Clone or Download option, or download the .zip file from the releases section.
2. Extract the archive to a local directory.
3. Open Command Prompt or PowerShell, navigate to the project root directory, and install the required dependencies:

pip install -r PyFCS\external\requirements.txt

4. Launch the graphical interface by executing:

python PyFCS\interface\mainInterface.py

---

Linux

1. Download and extract the project from GitHub.
2. Open a terminal and navigate to the project root directory.
3. Make the setup script executable (only required once):

chmod +x ./PyFCS/external/setup_pyfcs_linux.sh

4. Run the setup script:

./PyFCS/external/setup_pyfcs_linux.sh

Note:
The script automatically creates and activates a virtual environment, installs Python dependencies, and checks or installs system-level requirements such as Tkinter. Administrator permissions (sudo) may be required.

---

macOS

1. Download and extract the project from GitHub.
2. Open the Terminal and navigate to the project root directory.
3. Make the setup script executable (only required once):

chmod +x ./PyFCS/external/setup_pyfcs_mac.sh

4. Run the setup script:

./PyFCS/external/setup_pyfcs_mac.sh

Note:
The script automatically installs Python via Homebrew, sets up a virtual environment, installs dependencies, and verifies Tkinter.
Make sure Homebrew and the Xcode Command Line Tools are installed.