Skip to content

Running from source

document10 edited this page Dec 2, 2023 · 1 revision

Running from source

Running from source is useful for debugging taiga or if you are contributing. For most cases we reccomend running from the binary instead,as you don't need extra dependencies.

Base dependencies

When running TAIGA both from binaries and from source,you will need the same base dependencies. Check the Running from binary section to see what needs to be installed and configured.

Script dependencies

TAIGA is written in python,and uses simple-term-menu for creating the interactive menus (or TUI,Text-based User Interface),which is managed using pip.

Installing python and pip (requires root)

Arch Linux Debian/Ubuntu FreeBSD OpenSUSE Fedora Void Linux
pacman -S python python-pip apt install python3 python3-pip pkg install python py-pip zypper install python python-pip zypper install python python-pip xbps-install python python3-pip

Installing simple-term-menu

Creating a virtual environment (recommended)

Python virtual environments are separate from the main system,which eliminates the chances for version conflicts or accidentally breaking some dependencies.To create a python virtual environment in the current directory and install simple-term-menu to it use the following commands:

python3 -m venv $(pwd)
bin/pip install --upgrade pip
bin/pip install simple-term-menu

You can also use the create_env.sh from the scripts directory to create a virtual environment suitable for running TAIGA as well as compiling the binary.

cd scripts
sh create_env.sh

Using pip (not recommended)

To install simple-term-menu you can use either one of these commands:

sudo pip install simple-term-menu

or

pip install --user simple-term-menu

Keep in mind that if your distro uses PEP 668 this method won't be possible and you will need to add the --break-system-packages option.
WARNING:This method is not recommended since it can cause problems with other applications.Use virtual environments instead.

Running the script

Method No config With config
Shell commands ./taiga.py ./taiga.py [configfile]
Python python taiga.py python taiga.py [configfile]
Python 3 python3 taiga.py python3 taiga.py [configfile]

Notes:

  • Replace [configfile] with the path to the config.
  • If you can't run the script, you may need to run chmod u=rwx taiga.py to give yourself the required permissions.
Clone this wiki locally