---
id: edgegrid-python
version: "2.0.7"
license: Apache 2.0
license_treatment: permissive
maintenance: active
---

# edgegrid-python — {OPEN} client authentication protocol for python-requests

License: permissive · Maintenance: active · Downloads: 878.8K/mo

## What it is and what it does

EdgeGrid for Python is an authentication handler that integrates with the requests library to sign HTTP requests using the EdgeGrid Authentication scheme. It allows you to authenticate API calls by managing credentials (client token, client secret, access token) and automatically computing request signatures with timestamps. The library reads credentials from a local .edgerc configuration file or accepts them as constructor arguments, then attaches the computed authentication headers to outgoing requests.

The package is designed for developers building Python applications that interact with APIs requiring EdgeGrid authentication. It handles the cryptographic signing and header construction transparently, so you work with requests as normal—passing headers, query parameters, and request bodies—while the authentication layer manages signing. It supports multipart form data via requests_toolbelt and file-like objects for request bodies, and includes debugging facilities for logging request details.

Use it for:

- Authenticate requests to APIs from a Python application or script using EdgeGrid credentials.
- Build automation tools that interact with identity management, configuration, or reporting endpoints.
- Integrate API calls into a larger Python service without manually computing EdgeGrid signatures.
- Debug and log API interactions during development using the built-in logging support.
- Deploy credential-based API clients that read authentication from .edgerc files for multi-environment setups.

## Worth the install?

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

Provides an authentication handler for HTTP requests using Akamai's EdgeGrid Authentication scheme, integrating with the requests library to sign API calls.

Yes. The package is actively maintained, has no known vulnerabilities, installs with low friction, and is the standard way to authenticate EdgeGrid API requests from Python. Install it if you need to call EdgeGrid-authenticated APIs from a Python application.

## Install

pip install edgegrid-python
uv add edgegrid-python
poetry add edgegrid-python

## Installing edgegrid-python

Before you install: Low friction install with only two runtime dependencies (requests and requests_toolbelt). The package is actively maintained with a recent release and no known vulnerabilities.

License in practice: Licensed under Apache 2.0 (permissive), allowing commercial and private use with minimal restrictions beyond attribution and liability disclaimers.

Quickstart:

pip install edgegrid-python

import requests
from edgegrid_python import EdgeGridAuth, EdgeRc

edgerc = EdgeRc('~/.edgerc')
session = requests.Session()
session.auth = EdgeGridAuth.from_edgerc(edgerc, 'default')
result = session.get('https://host.luna.akamaiapis.net/path')

Requires Python 3.10 or later; credentials must be configured in a .edgerc file or passed explicitly to EdgeGridAuth.

Verify before relying:

- Whether the package supports HTTP/2 or other modern protocol features beyond standard HTTP/1.1 signing.
- Performance characteristics when handling high-volume or concurrent requests.
- Compatibility with async/await patterns or if it is synchronous-only.

## Package facts

- License: Apache 2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 878.8K/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

akamai edgegrid authentication, http request signing, api authentication handler, edgegrid python requests, akamai api client auth, request signing library, request-signing, authentication

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