Ethos requires Python 3.9+ and VLC player installed in the system. It is multi-platform and the goal is to make it work equally well on Linux, macOS, and Windows.
Installation
If you are viewing documentation for the development branch, you may wish to install a preview or development version of Ethos. See the advanced installation instructions to use a preview or alternate version of Ethos.
is used to install Python CLI applications globally while still isolating them in virtual environments. pipx will manage upgrades and uninstalls when used to install Ethos.
1
Install pipx
If pipx is not already installed, you can follow any of the options in the . Any non-ancient version pipx will do.
2
Install Ethos
pipx install ethos-cli
3
Verify the Installation
After installation, check if Ethos is installed correctly by running:
ethos-cli --version
If Ethos is installed properly, this command should output the installed version.
4
Install Ethos (advanced)
You can skip this step if you want the latest version and already installed Ethos as described in the previous step. This step details the advanced usage of this installation method. For example, installing Ethos from source, having multiple versions installed simultaneously, etc.
pipx can install different versions of Ethos, using the same syntax as pip:
pipx install ethos-cli==0.1.2
pipx can also install versions of Ethos in parallel, which allows for easy testing of alternate or prerelease versions. Each version is given a unique, user-specified suffix, which will be used to create a unique binary name:
pip is the default package manager for Python. It allows users to install, upgrade, and manage Python packages from the . pip installs package system-wide or in user-specific directories, depending on the installation method.
1
Install Ethos
To install Ethos globally using pip, simply run:
pip install ethos-cli
If you want to install a specific version, use:
pip install ethos-cli==0.1.0
If you see the following error when running ethos in your Windows terminal:
'ethos' is not recognized as an internal or external command,
operable program, or batch file.
This issue occurs because Ethos might not be in your system’s PATH.
Check the for step-by-step instructions on how to fix this.
2
Verify the Installation
After installation, check if Ethos is installed correctly by running:
ethos-cli --version
If Ethos is installed properly, this command should output the installed version.
3
Updating Ethos
pip install --upgrade ethos-cli
4
Uninstalling Ethos
pip uninstall ethos-cli
It is generally recommended to use pipx or a virtual environment. pipx is particularly useful for CLI applications like Ethos because it installs them in a dedicated environment while still making them accessible system-wide while avoiding PATH errors.
If you prefer not to use pipx, you can also install Ethos inside a virtual environment using venv, or docker which provides similar isolation benefits.
