Skip to content

Installation

Jump to bottom
Lokesh Kumar edited this page Aug 7, 2026 · 3 revisions

Installation Guide

This guide covers all the ways to install, update, and remove pkgwrap across different environments.

Prerequisites

pkgwrap requires Python 3.9 or higher. Most modern Linux distributions and macOS versions come with this pre-installed.

Method 1: Using pip (Recommended)

If you already have a working Python environment, installing via PyPI is the fastest and cleanest method.

# Install for the current user
pip install pkgwrap-lokesh

# If your system uses pipx for CLI tools (e.g., modern Debian/Ubuntu)
pipx install pkgwrap-lokesh

Method 2: Using the Install Script

If you don't have pip configured or want a hands-off installation, use the provided bootstrap script. It will attempt to install Python and pip using your system's native package manager before installing pkgwrap.

Standard Installation:

curl -fsSL [https://raw.githubusercontent.com/trmxvibs/pkgwrap/main/install.sh](https://raw.githubusercontent.com/trmxvibs/pkgwrap/main/install.sh) | bash

Source Installation (for contributors): If you want to edit the code locally, you can clone the repository and use the --source flag. This sets up a Python virtual environment and installs pkgwrap in editable mode (pip install -e .).

git clone [https://github.com/trmxvibs/pkgwrap.git](https://github.com/trmxvibs/pkgwrap.git)
cd pkgwrap
bash install.sh --source

📱 Termux-Specific Notes (Android)

Termux provides a minimal environment by default. Before you can install pkgwrap from source or use pip, you must ensure Python and Git are installed.

Run this first:

pkg install python git

After that, you can proceed with the pip or --source installation methods above.

Upgrading and Uninstalling

To grab the latest features and backend fixes, upgrade the package via pip:

pip install --upgrade pkgwrap-lokesh

To entirely remove pkgwrap from your system:

pip uninstall pkgwrap-lokesh

⚠️ Troubleshooting

"Command not found: pkgwrap" after pip install

If you used pip install but your terminal says the command doesn't exist, your user's local binary directory is likely missing from your system's PATH.

  1. Open your shell configuration file (e.g., ~/.bashrc or ~/.zshrc).
  2. Add the following line to the bottom: 
    export PATH="$HOME/.local/bin:$PATH"
  3. Reload your shell: 
    source ~/.bashrc  # or ~/.zshrc

Clone this wiki locally