django-ipware
A Django application to retrieve user's IP address
Decision gist · record as of 2026-08-14
Yes, if you are running Django behind one or more proxies and need reliable client IP extraction. The package is stable (Production/Stable classifier), supports modern Python versions (3.8–3.12), has no known vulnerabilities, and low install friction. Dormant maintenance is acceptable for a focused, mature utility. Not necessary if your Django app runs without proxies or if you handle IP extraction via your proxy/load balancer configuration.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Django request object; IP spoofing is not prevented—use trusted_proxies_ips or proxy_count parameters to validate against known proxy infrastructure.
- Low friction: pure Python wheel with a single runtime dependency (python-ipware).
- Maintenance is dormant—last release was 847 days ago, though the repository remains active with 1066 stars and no archived status.
License · maintenance · safety
MIT (permissive) — MIT license is permissive and poses no restrictions on commercial or proprietary use. You may use, modify, and distribute this package freely provided you retain the license notice.
last release 2024-04-19 (847 days) · last repo commit 2024-04-19 · 1,066 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 5,884,830 downloads/mo, #2,017 on PyPI
Alternatives
Verify before relying
pip install django-ipware
from ipware import get_client_ip
client_ip, is_routable = get_client_ip(request)
if client_ip:
print(f"Client IP: {client_ip}, Routable: {is_routable}")- Exact behavior differences between django-ipware and its underlying dependency python-ipware beyond the wrapper layer.
- Performance characteristics when handling requests with many proxy headers or large header lists.
- Whether dormant maintenance status indicates sufficient stability for new projects or signals deprecation risk.
What it is and what it does
django-ipware is a Django wrapper around the python-ipware library that extracts a client's originating IP address from a request object. It handles the complexity of proxy headers—such as X-Forwarded-For, X-Real-IP, and CloudFlare headers—by checking them in a configurable precedence order. The package returns both the IP address and a boolean indicating whether it is publicly routable.
The main use case is in Django views or middleware where you need to log, authenticate, or make decisions based on the client's real IP rather than the immediate request source (which may be a load balancer or reverse proxy). It supports advanced scenarios like trusted proxy lists, proxy count filtering, and custom header precedence orders via Django settings or function parameters. The package explicitly warns that it is not a complete defense against IP spoofing and should be layered with firewall rules and authentication measures.
Use it for
- Log the real client IP in Django middleware or views when behind a load balancer or CDN.
- Validate client IP against a trusted proxy list to filter spoofed requests in security-sensitive operations.
- Extract originating client IP for rate limiting, geolocation, or fraud detection workflows.
- Configure custom header precedence for non-standard proxy setups (e.g., internal corporate proxies).
- Determine whether a client IP is private or publicly routable for conditional business logic.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are running Django behind one or more proxies and need reliable client IP extraction.
The package is stable (Production/Stable classifier), supports modern Python versions (3.8–3.12), has no known vulnerabilities, and low install friction. Dormant maintenance is acceptable for a focused, mature utility. Not necessary if your Django app runs without proxies or if you handle IP extraction via your proxy/load balancer configuration.
Install
django-ipware on PyPI
Before you install
Low friction: pure Python wheel with a single runtime dependency (python-ipware). Maintenance is dormant—last release was 847 days ago, though the repository remains active with 1066 stars and no archived status. Suitable for stable, non-evolving use cases.
Requires Django request object; IP spoofing is not prevented—use trusted_proxies_ips or proxy_count parameters to validate against known proxy infrastructure.
License in practice
MIT license is permissive and poses no restrictions on commercial or proprietary use. You may use, modify, and distribute this package freely provided you retain the license notice.
Quickstart
pip install django-ipware
from ipware import get_client_ip
client_ip, is_routable = get_client_ip(request)
if client_ip:
print(f"Client IP: {client_ip}, Routable: {is_routable}")Verify before relying
- Exact behavior differences between django-ipware and its underlying dependency python-ipware beyond the wrapper layer.
- Performance characteristics when handling requests with many proxy headers or large header lists.
- Whether dormant maintenance status indicates sufficient stability for new projects or signals deprecation risk.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.8 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagepython-ipware |
| Maintenance | Dormant 847 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 5,884,830 / month, #2,017 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseNatural Language :: EnglishProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9 |
Evidence: django_ipware-7.0.1-py2.py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “django get client ip address”
- django-ipwareRetrieves the client's IP address from a Django request object,…
- python-ipwareExtracts a client's IP address from web request headers, handling…
- django-ratelimitProvides a Django decorator to rate-limit views based on IP address…
Give your agent the search over MCP, or paste the wish link into any chat.
More WWW/HTTP packages
urllib3 is an HTTP client library that provides thread-safe connection pooling, SSL/TLS verification, multipart file uploads, request retries, compression support, and proxy handling for Python applications.
Requests is a Python HTTP library that simplifies sending HTTP/1.1 requests with automatic handling of headers, authentication, cookies, and response parsing.
h11 is a pure-Python HTTP/1.1 protocol implementation that handles parsing and serializing HTTP messages without any built-in I/O, letting you integrate it with any network layer you choose.
HTTPX is a fully featured HTTP client library for Python that provides both sync and async APIs, with support for HTTP/1.1 and HTTP/2, plus an integrated command-line client.
Install it if you are building new projects or modernizing existing ones that rely on HTTP.
A minimal low-level HTTP client library that sends HTTP requests with thread-safe and task-safe connection pooling, supporting HTTP/1.1, HTTP/2, proxies, and both sync and async interfaces.
aiohttp is an async HTTP client and server framework built on asyncio, supporting both WebSockets and middleware-based routing for building concurrent web applications.
Install it if you need async HTTP client or server capabilities in asyncio-based applications.
See also django-xff · proxy-protocol · python-ipware · django-revproxy · proxyproviders · django-cors-headers · vercel-headers · django-axes · django-netfields · iptools