---
id: agithub
version: "2.2.2"
license: MIT
license_treatment: permissive
maintenance: dormant
---

# agithub — A lightweight, transparent syntax for REST clients

License: permissive · Maintenance: dormant · Downloads: 73.6K/mo

## What it is and what it does

Agithub is a REST API client that translates Python attribute and method chains directly into HTTP requests, eliminating boilerplate and making API calls read like the underlying protocol. Instead of building URL strings and managing headers manually, you write `client.repos.owner.name.issues.get()` and agithub handles the HTTP details—serializing parameters, encoding URLs, and returning status and response body as a tuple.

The package ships with implementations for GitHub, Facebook, DigitalOcean, OpenWeatherMap, and SalesForce, but its core design is protocol-agnostic: you can add support for any REST API with minimal code. It handles GET, POST, PUT, and PATCH requests, accepts custom headers and query parameters as function arguments, and exposes response headers via `getheaders()`. Errors are passed through transparently—networking exceptions bubble up normally, and API errors appear in the response status and body, letting you handle them directly.

Use it for:

- Rapid prototyping of GitHub integrations without learning a full SDK or managing authentication boilerplate.
- Building scripts that interact with multiple REST APIs (GitHub, Facebook, DigitalOcean) using a uniform syntax.
- Querying public REST APIs (like OpenWeatherMap) from Python scripts without installing service-specific clients.
- Adding REST API support to a custom service by extending agithub with 30 lines of code.
- Exploring an unfamiliar REST API interactively in a Python REPL without pre-building request objects.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A lightweight REST API client with transparent Python syntax that maps directly to HTTP requests, supporting GitHub, Facebook, DigitalOcean, OpenWeatherMap, SalesForce, and other REST APIs with minimal boilerplate.

Yes, if you need a lightweight, syntax-transparent REST client for prototyping or simple integrations with GitHub or other public APIs. No, if you require active maintenance, modern Python-only support, or expect bug fixes—the package is dormant (last release 2019-11-12) and shows no signs of active development. It is stable and permissively licensed, but treat it as a mature, frozen tool rather than an actively supported library.

## Install

pip install agithub
uv add agithub
poetry add agithub

## Installing agithub

Before you install: Low install friction with no runtime dependencies. Maintenance is dormant—last release was 2019-11-12 and last commit 2024-06-24—so expect no active bug fixes or feature development, though the codebase is stable and archived status is false.

License in practice: MIT license is permissive, allowing commercial and private use with minimal restrictions; you may use, modify, and distribute agithub freely as long as you include the license notice.

Quickstart:

from agithub.GitHub import GitHub
g = GitHub()
status, data = g.users.octocat.get()
print(data['name'], status)

Verify before relying:

- Whether Python 2.6 support (listed in classifiers) is actually maintained or tested.
- Current compatibility with modern Python versions beyond what classifiers indicate.
- Whether the package works with current versions of the APIs it claims to support.

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: dormant
- Downloads: 73.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

REST API client Python, GitHub API wrapper, lightweight HTTP client, transparent REST syntax, multi-API client library, agnostic REST API, rapid API prototyping, rest-client, api-wrapper, github-integration

[View on SkillFed](https://skillfed.io/packages/agithub) · [View on PyPI](https://pypi.org/project/agithub/)