pipg

A fast Python package installer written in Go. Drop-in replacement for pip install - downloads packages concurrently using goroutines.

pipg is NOT a project manager, virtual environment manager, or build tool. It simply installs packages, just like pip install, but faster.

---

Installation

Install from source:

go install github.com/bilusteknoloji/pipg/cmd/pipg@latest

Install from brew:

brew install bilusteknoloji/pipg/pipg

---

Usage

pipg install requests
pipg install "flask>=3.0" "sqlalchemy<2.0"
pipg install -r requirements.txt

Flags

pipg -h

pipg is a drop-in replacement for pip install that downloads packages concurrently.

Usage:
  pipg [command]

Available Commands:
  completion  Generate the autocompletion script for the specified shell
  help        Help about any command
  install     Install Python packages

Flags:
  -h, --help      help for pipg
  -v, --version   version for pipg

Use "pipg [command] --help" for more information about a command.

pipg install -h
Install Python packages

Usage:
  pipg install [packages...] [flags]

Flags:
      --dry-run               Show the plan without downloading or installing
  -h, --help                  help for install
  -j, --jobs int              Max concurrent downloads (default: GOMAXPROCS)
      --no-deps               Skip dependencies, install only specified packages
      --python string         Python binary to use (default "python3")
  -r, --requirements string   Install from requirements file
      --target string         Target directory (default: auto-detect site-packages)
  -v, --verbose               Verbose output

---

How It Works

CLI parse args
  → Detect Python environment (venv / system)
  → Fetch metadata from PyPI JSON API
  → Build dependency tree (resolver)
  → Select compatible wheel for each package (PEP 425)
  → Concurrent download with SHA256 verification
  → Install wheels to site-packages
  → Print result summary

---

Architecture

pipg/
├── cmd/pipg/          CLI entry point
├── internal/
│   ├── pypi/          PyPI JSON API client
│   ├── resolver/      Dependency resolution + PEP 440/508 parsing
│   ├── downloader/    Concurrent download manager + wheel selection
│   ├── installer/     Wheel extraction to site-packages
│   ├── cache/         Wheel cache (SHA256-verified)
│   └── python/        Python environment detection

---

Cache

Downloaded wheels are cached locally and reused on subsequent installs. Cache hits are verified with SHA256 before use — corrupted files are automatically removed.

Default cache location:

Platform	Path
macOS	~/Library/Caches/pipg/wheels
Linux	~/.cache/pipg/wheels (or $XDG_CACHE_HOME/pipg/wheels)

Override with the PIPG_CACHE_DIR environment variable:

export PIPG_CACHE_DIR=/tmp/my-pipg-cache
pipg install requests

Cached packages show (cached) in the output:

Downloading 3 packages (8 workers)...
  ✓ requests-2.31.0-py3-none-any.whl (101 KB) (cached)
  ✓ charset-normalizer-3.3.2-py3-none-any.whl (48 KB) (cached)
  ✓ idna-3.6-py3-none-any.whl (61 KB)

---

Development

# Build
go build ./...

# Test
go test -race -count=1 ./...

# Lint
golangci-lint run ./...

---

License

This project is licensed under MIT

---

This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.