netifaces
Portable network interface information.
Decision gist · record as of 2026-08-14
No—not recommended for new projects. The package is abandoned (last release 2021-05-31, repository archived, maintainer explicitly unable to continue). While it works and has no known vulnerabilities, there is no active maintenance, no response to issues or pull requests, and no guarantee of compatibility with future Python or OS versions.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires C compiler and platform development tools to build the extension during installation (tar/setup.py or pip will compile from source on most systems).
- Medium install friction due to C extension compilation required on installation.
- Package is abandoned as of 2021-05-31 with no active maintenance; the original maintainer explicitly stated they can no longer maintain it.
License · maintenance · safety
MIT License (permissive) — MIT License (permissive) allows commercial and private use with minimal restrictions, requiring only license and copyright notice retention.
last release 2021-05-31 (1901 days) · last repo commit 2021-05-31 · 338 stars · archived
0 known vulnerabilities (OSV.dev, 2026-08-14) · 2,666,675 downloads/mo, #2,951 on PyPI
Alternatives
Verify before relying
import netifaces
# List all network interfaces
interfaces = netifaces.interfaces()
# Get addresses for a specific interface
addrs = netifaces.ifaddresses('lo0')
ipv4_addrs = addrs[netifaces.AF_INET]
# Get gateway information
gateways = netifaces.gateways()
default_gw = gateways['default'][netifaces.AF_INET]- Whether the package works reliably on modern Python versions despite being abandoned since 2021
- Whether pre-built wheels for recent Python versions are available or if compilation is always required
- Known compatibility issues or regressions on current operating systems
What it is and what it does
netifaces is a Python library that abstracts away the platform-specific complexity of querying network interface information. Instead of writing different code for Linux, macOS, Windows, and other systems, you import netifaces and call simple functions to enumerate interfaces, retrieve their addresses (IPv4, IPv6, MAC), and discover gateway configuration. It returns results as dictionaries keyed by address family, allowing you to handle multiple addresses per interface and different address types uniformly.
The package solves the portability problem by wrapping low-level system APIs into a single consistent interface. You can list all interfaces, query addresses for a specific interface by family, retrieve hardware addresses, and access default or non-default gateways—all without worrying about whether you're running on POSIX or Windows.
Use it for
- Enumerate all network interfaces and their IP addresses to discover local network configuration in a cross-platform tool.
- Retrieve MAC addresses for network interfaces to identify hardware or implement network-based licensing.
- Query default gateway information to route traffic or configure network policies programmatically.
- Build network monitoring or diagnostics utilities that need to work on Linux, macOS, and Windows without platform-specific code.
- Detect IPv6 addresses alongside IPv4 to support dual-stack network applications.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
No—not recommended for new projects.
The package is abandoned (last release 2021-05-31, repository archived, maintainer explicitly unable to continue). While it works and has no known vulnerabilities, there is no active maintenance, no response to issues or pull requests, and no guarantee of compatibility with future Python or OS versions.
Install
netifaces on PyPI
Before you install
Medium install friction due to C extension compilation required on installation. Package is abandoned as of 2021-05-31 with no active maintenance; the original maintainer explicitly stated they can no longer maintain it. Repository is archived.
Requires C compiler and platform development tools to build the extension during installation (tar/setup.py or pip will compile from source on most systems).
License in practice
MIT License (permissive) allows commercial and private use with minimal restrictions, requiring only license and copyright notice retention.
Quickstart
import netifaces
# List all network interfaces
interfaces = netifaces.interfaces()
# Get addresses for a specific interface
addrs = netifaces.ifaddresses('lo0')
ipv4_addrs = addrs[netifaces.AF_INET]
# Get gateway information
gateways = netifaces.gateways()
default_gw = gateways['default'][netifaces.AF_INET]Verify before relying
- Whether the package works reliably on modern Python versions despite being abandoned since 2021
- Whether pre-built wheels for recent Python versions are available or if compilation is always required
- Known compatibility issues or regressions on current operating systems
Package facts
| License | MIT License permissive |
| Python support | Not specified |
| Install friction | Medium. Platform-specific wheel |
| Runtime dependencies | None |
| Maintenance | Abandoned 1,901 days since the last release |
| Last repo commit | repository archived |
| First released | |
| Downloads | 2,666,675 / month, #2,951 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseProgramming Language :: PythonProgramming Language :: Python :: 2Programming Language :: Python :: 2.7Programming Language :: Python :: 3Programming Language :: Python :: 3.4Programming Language :: Python :: 3.5Programming Language :: Python :: 3.6Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Topic :: System :: Networking |
Evidence: netifaces-0.11.0-cp27-cp27m-manylinux_2_5_i686.manylinux1_i686.whl; netifaces-0.11.0-cp27-cp27m-manylinux_2_5_x86_64.manylinux1_x86_64.whl; netifaces-0.11.0-cp27-cp27mu-manylinux_2_5_i686.manylinux1_i686.whl; netifaces-0.11.0-cp27-cp27mu-manylinux_2_5_x86_64.manylinux1_x86_64.whl; netifaces-0.11.0-cp27-cp27m-win32.whl; netifaces-0.11.0-cp27-cp27m-win_amd64.whl; netifaces-0.11.0-cp34-cp34m-win32.whl; netifaces-0.11.0-cp35-cp35m-manylinux_2_5_i686.manylinux1_i686.whl; netifaces-0.11.0-cp35-cp35m-manylinux_2_5_x86_64.manylinux1_x86_64.whl; netifaces-0.11.0-cp35-cp35m-win32.whl; netifaces-0.11.0-cp36-cp36m-macosx_10_15_x86_64.whl; netifaces-0.11.0-cp36-cp36m-manylinux_2_5_i686.manylinux1_i686.whl; netifaces-0.11.0-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.whl; netifaces-0.11.0-cp36-cp36m-win32.whl; netifaces-0.11.0-cp36-cp36m-win_amd64.whl; netifaces-0.11.0-cp37-cp37m-macosx_10_15_x86_64.whl; netifaces-0.11.0-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.whl; netifaces-0.11.0-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.whl; netifaces-0.11.0-cp37-cp37m-win32.whl; netifaces-0.11.0-cp37-cp37m-win_amd64.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 › “network interface addresses python”
- netifacesProvides portable access to network interface information (addresses,…
- ifaddrEnumerate network interfaces and their IP addresses across Linux,…
- netifaces2Retrieves network interface information (addresses, gateways,…
Give your agent the search over MCP, or paste the wish link into any chat.
More Networking packages
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.
psutil retrieves real-time information about running processes and system resources (CPU, memory, disks, network, sensors) across multiple operating systems, enabling system monitoring, process profiling, and resource management.
pyOpenSSL wraps OpenSSL's SSL/TLS functionality for Python, providing high-level connection objects and certificate handling through a Python-friendly interface around OpenSSL's cryptographic operations.
uvloop is a drop-in replacement for Python's built-in asyncio event loop, implemented in Cython and using libuv, that accelerates async I/O operations.
execnet lets you spawn and communicate with Python interpreters across local processes, remote hosts, and different platforms, using a simple API for task distribution and inter-process messaging.
However, the aging maintenance status (275 days since last release) means you should verify it meets your concurrency and performance needs before committing to a…
PyZMQ provides Python bindings for ZeroMQ (ØMQ), a lightweight messaging library that enables fast, asynchronous communication between distributed processes and applications.
See also netifaces-plus · netifaces2 · ifcfg · ifaddr · getmac · netaddr · pyroute2 · django-netfields · ipaddress · ipaddr