Warning: `qet` is currently a work-in-progress project. It is highly recommended to test it on a virtual machine or a disposable environment rather than your primary system.

Install qet

This page provides instructions on how to download and install the qet command-line application.

Prerequisites

Before installing qet, ensure you have the following installed on your system:

Python 3.8+: qet is a Python application.
Git: For cloning the repository.

Installation

The qet application can be installed directly from its GitHub repository. This method ensures you get the latest version of the application.

Clone the repository: First, clone the qet-cli repository from GitHub to your local machine:
```
git clone https://github.com/qetapp/qet-cli.git
cd qet-cli
```
Install dependencies and qet: qet is a Python application. You can install it and its dependencies using pip in editable mode. This is useful for development and ensures that any changes you make to the source code are immediately reflected.
```
pip install -e .
```
If you only want to install the dependencies without installing qet in editable mode, you can use:
```
pip install .
```
Verify installation: After installation, you should be able to run qet from your terminal:
```
qet --version
```

Post-Installation Setup

After installing qet, you might want to:

Configure conf.toml: Customize qet's behavior by editing the conf.toml file. Refer to the Documentation for details.
Update Definitions: Run qet update to fetch the latest package definitions.

If you encounter any issues during installation, please refer to the troubleshooting guide or open an issue on the GitHub repository.

Troubleshooting

`qet: command not found`

If you see this error, it means the qet executable is not in your system's PATH. This often happens when pip installs packages to a user-specific directory (e.g., ~/.local/bin).

Solution: Add the pip user base directory to your PATH. You can find this directory by running:

python -m site --user-base

Then, add the bin subdirectory of that path to your shell's configuration file (e.g., .bashrc, .zshrc). For example:

export PATH="$PATH:/home/youruser/.local/bin"

Remember to source your shell's configuration file after editing it (e.g., source ~/.bashrc).