Registry / devops / ghr-bin

ghr-bin

JSON →
cli0.1.6pypypiunverified

Install tools from GitHub releases via CLI. Version 0.1.6 (stable) with 0.2.0-dev.3 pre-release. Active development, published as a Python shim that downloads a native binary.

devops
uv tool install ghr-bin==0.1.6
github ↗package ↗
INSTALL
IMPORT
SIG · GHR-BIN
G
ghr-bin
devopspythonv0.1.6
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

ghr
✓ from ghr import __main__
✗ import ghr
ghr-bin is a CLI tool; there is no public Python API. Importing ghr as a module does nothing.

Run ghr install from Python via subprocess. The tool is meant for CLI use, not as a library.

import subprocess subprocess.run(["ghr", "install", "cli/cli"], check=True)
ghr --version
Debug
Known issues
gotchaghr-bin installs as a shim that downloads a native binary; the 'ghr' executable is not the Python script but a binary. Ensure path includes the uv/pipx tool bin directory.
fix
After install, run `ghr --help` to verify it works. If not found, add `~/.local/bin` (Linux) or `%USERPROFILE%\.local\bin` (Windows) to PATH.
affects: all
deprecatedInstalling via `pip install ghr-bin==0.1.6` may work but is discouraged; the project recommends `uv tool install` or `pipx install`.
fix
Use `uv tool install ghr-bin` or `pipx install ghr-bin` instead of `pip install`.
affects: >=0.1.0
gotchaVersion 0.2.0-dev.x are pre-releases with manual installation only (`uv tool install ghr-bin==0.2.0.dev3`). They are not listed on PyPI by default.
fix
To try dev versions, specify full version with `==` and allow pre-releases: `uv tool install ghr-bin==0.2.0.dev3`.
affects: 0.2.0-dev*
breakingPyPI wheels on Windows previously missed shim.exe (v0.1.0). Fixed in v0.1.1.
fix
Upgrade to >=0.1.1.
affects: 0.1.0
Errors
Common errors & fixes
ghr: command not found
ghr binary not on PATH; uv/pipx install location not in PATH.
fix
Add uv/pipx bin directory to PATH: `export PATH="$HOME/.local/bin:$PATH"` (Linux/macOS) or add `%USERPROFILE%\.local\bin` (Windows).
error: No asset found for platform
ghr could not find a GitHub release asset matching the current OS/arch.
fix
Specify a release tag with `--tag` or use a repository that publishes assets for your platform. Check available assets with `ghr list owner/repo`.
AttributeError: module 'ghr' has no attribute '...'
Attempting to import ghr as a Python module; ghr-bin has no public API.
fix
Use subprocess to call the ghr CLI: `subprocess.run(['ghr', 'install', 'owner/repo'])`.
Upgrade
Version history
0.1.6latest on PyPI · released Apr 16, 2026
Audit
Dependencies
uvrequiredPrimary install tool; most users use `uv tool install`
pipxoptionalInstallation via pipx also works
Agent activity
24 hits · last 30 days
node
22
Resources
githubhttps://github.com/cataggar/ghr ↗
packagehttps://pypi.org/project/ghr-bin/ ↗
ghr-bin — pip install ghr-bin · libregistry