# Install and Upgrade the CLI The `biosimulant` package on PyPI is the canonical CLI distribution. ## Recommended: pipx `pipx` keeps command-line applications isolated while exposing their commands on your `PATH`. ```bash pipx install biosimulant biosimulant --version ``` Upgrade in place: ```bash pipx upgrade biosimulant ``` Install an exact release: ```bash pipx install "biosimulant==0.0.22" ``` ## Alternative: uv ```bash uv tool install biosimulant uv tool upgrade biosimulant ``` Pin an exact release with: ```bash uv tool install "biosimulant==0.0.22" ``` ## Project or CI environment For a virtual environment or locked CI job: ```bash python -m pip install "biosimulant==0.0.22" python -m biosimulant --version ``` Avoid an unpinned install in reproducible CI workflows. ## Desktop Desktop contains the exact wheel and dependency lock tested with that Desktop release. Use **Settings > CLI Tools** to provision or repair the managed package and shell launcher. ## Cloud Studio Cloud Studio workspaces already contain the CLI. Do not reinstall it inside a workspace unless a support procedure explicitly asks you to do so. ```bash biosimulant --version biosimulant doctor ``` ## Shell completion For bash: ```bash register-python-argcomplete biosimulant >> ~/.bash_completion ``` For zsh: ```bash autoload -U bashcompinit bashcompinit eval "$(register-python-argcomplete biosimulant)" ```