ghpush

0.1.8 verified Sat May 09 auth: no python

An AI tool for pushing files to GitHub repositories with automatic commit and pull request creation. Current version 0.1.8, supports Python >=3.8. Low release cadence.

pip install ghpush

Common errors

error Error: Missing required environment variable GITHUB_TOKEN ↓

cause GITHUB_TOKEN not set before running ghpush.

fix

Set environment variable: export GITHUB_TOKEN='your_token' (or set in Python via os.environ).

error ModuleNotFoundError: No module named 'gpush' ↓

cause Old package name 'gpush' used, but package was renamed to 'ghpush'.

fix

Uninstall gpush (pip uninstall gpush) and install ghpush (pip install ghpush).

Warnings

gotcha Environment variables must be set before calling ghpush. Missing any of GITHUB_TOKEN, REPO_OWNER, REPO_NAME will cause failure. ↓

fix Set environment variables or pass via command-line options (not supported in programmatic use).

gotcha The library is primarily a CLI tool. Programmatic Python usage is not documented and may not be stable. ↓

fix Use the CLI interface: `ghpush /path/to/file`. For scripting, use subprocess calls.

deprecated Early versions were named 'gpush'. The package was renamed to 'ghpush' from version 0.1.1. ↓

fix If you see 'gpush' in old code, update to 'ghpush' and reinstall.

Imports

ghpush
```
import ghpush
```
No common wrong import path; library is imported as a module.

Quickstart

Setup requires GITHUB_TOKEN, REPO_OWNER, REPO_NAME environment variables. Main usage is CLI: ghpush <files>.

import ghpush
import os

# Set required environment variables
os.environ['GITHUB_TOKEN'] = ''  # Replace with your token
os.environ['REPO_OWNER'] = 'owner'
os.environ['REPO_NAME'] = 'repo_name'

# Push files using CLI (programmatic usage not documented)
# Run from command line: ghpush /path/to/files