{"id":27831,"library":"ghr-bin","title":"ghr-bin","description":"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.","status":"active","version":"0.1.6","language":"python","source_language":"en","source_url":"https://github.com/cataggar/ghr","tags":["cli","github-releases","tool-installer","binary-shim"],"install":[{"cmd":"uv tool install ghr-bin==0.1.6","lang":"bash","label":"Recommended (uv)"},{"cmd":"pipx install ghr-bin==0.1.6","lang":"bash","label":"Alternative (pipx)"}],"dependencies":[{"reason":"Primary install tool; most users use `uv tool install`","package":"uv","optional":false},{"reason":"Installation via pipx also works","package":"pipx","optional":true}],"imports":[{"note":"ghr-bin is a CLI tool; there is no public Python API. Importing ghr as a module does nothing.","wrong":"import ghr","symbol":"ghr","correct":"from ghr import __main__"}],"quickstart":{"code":"import subprocess\nsubprocess.run([\"ghr\", \"install\", \"cli/cli\"], check=True)","lang":"python","description":"Run ghr install from Python via subprocess. The tool is meant for CLI use, not as a library."},"warnings":[{"fix":"After install, run `ghr --help` to verify it works. If not found, add `~/.local/bin` (Linux) or `%USERPROFILE%\\.local\\bin` (Windows) to PATH.","message":"ghr-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.","severity":"gotcha","affected_versions":"all"},{"fix":"Use `uv tool install ghr-bin` or `pipx install ghr-bin` instead of `pip install`.","message":"Installing via `pip install ghr-bin==0.1.6` may work but is discouraged; the project recommends `uv tool install` or `pipx install`.","severity":"deprecated","affected_versions":">=0.1.0"},{"fix":"To try dev versions, specify full version with `==` and allow pre-releases: `uv tool install ghr-bin==0.2.0.dev3`.","message":"Version 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.","severity":"gotcha","affected_versions":"0.2.0-dev*"},{"fix":"Upgrade to >=0.1.1.","message":"PyPI wheels on Windows previously missed shim.exe (v0.1.0). Fixed in v0.1.1.","severity":"breaking","affected_versions":"0.1.0"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Add uv/pipx bin directory to PATH: `export PATH=\"$HOME/.local/bin:$PATH\"` (Linux/macOS) or add `%USERPROFILE%\\.local\\bin` (Windows).","cause":"ghr binary not on PATH; uv/pipx install location not in PATH.","error":"ghr: command not found"},{"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`.","cause":"ghr could not find a GitHub release asset matching the current OS/arch.","error":"error: No asset found for platform"},{"fix":"Use subprocess to call the ghr CLI: `subprocess.run(['ghr', 'install', 'owner/repo'])`.","cause":"Attempting to import ghr as a Python module; ghr-bin has no public API.","error":"AttributeError: module 'ghr' has no attribute '...'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}