Skip to content

Installation

Install lbx using your preferred Python package manager.

Why pipx?

pipx installs Python CLI tools in isolated environments, keeping your global Python setup clean while making the command available system-wide.

Install pipx

brew install pipx
pipx ensurepath
sudo apt update
sudo apt install pipx
pipx ensurepath
scoop install pipx
pipx ensurepath
python -m pip install --user pipx
python -m pipx ensurepath
python -m pip install --user pipx
python -m pipx ensurepath

Install lbx

pipx install lbx

Installation Complete

lbx is now available system-wide as the lbx command.

Verify Installation

lbx --version
lbx --help

Alternative: Using pip

Virtual Environment Recommended

Installing globally with pip can cause conflicts. Use pipx or a virtual environment instead.

python -m venv lbx-env
source lbx-env/bin/activate  # Windows: lbx-env\Scripts\activate
pip install lbx
pip install lbx

Upgrading

pipx upgrade lbx
pip install --upgrade lbx

Uninstalling

pipx uninstall lbx
pip uninstall lbx

Development Installation

For contributing to lbx development:

git clone https://github.com/jd-35656/lbx.git
cd lbx
pipx install --editable .

See Development Setup for detailed instructions.

System Requirements

Requirement Details
Python 3.10 or higher
Operating System Windows, macOS, Linux
Dependencies Installed automatically

Troubleshooting

Command Not Found

If lbx command is not found after installation:

pipx ensurepath
# Restart your terminal
# Ensure virtual environment is activated
source lbx-env/bin/activate

Permission Errors

On Unix systems, if you encounter permission errors:

# Use pipx instead of global pip
pipx install lbx

Python Version Issues

Ensure you have Python 3.10 or higher:

python --version

If you need to upgrade Python, visit python.org.

See Also

Getting Started:

For Developers:

External Resources: