---
id: pyobjc-framework-systemconfiguration
version: "12.2.2"
license: MIT
license_treatment: permissive
maintenance: active
---

# pyobjc-framework-SystemConfiguration — Wrappers for the framework SystemConfiguration on macOS

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

## What it is and what it does

This package wraps Apple's SystemConfiguration framework for use from Python, allowing macOS developers to query and interact with system network and configuration settings programmatically. It is part of the larger PyObjC project, which bridges Python and Objective-C frameworks on macOS.

The package depends on pyobjc-core and pyobjc-framework-Cocoa and is distributed as platform-specific wheels for macOS only. It supports Python 3.10 through 3.15, including free-threading variants. Since it is a thin wrapper around Apple's native framework, it does not include its own documentation—users must consult Apple's SystemConfiguration framework documentation and PyObjC's general translation guides to understand how to use specific APIs.

Use it for:

- Query network interface status and configuration from a Python macOS application
- Monitor system network reachability for connectivity-aware application behavior
- Access macOS network proxy settings programmatically for network client configuration
- Build macOS system utilities that need to read or respond to network configuration changes

## Worth the install?

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

Provides Python bindings to macOS's SystemConfiguration framework, enabling programmatic access to network and system configuration settings on Mac systems.

Yes, if you are developing on or for macOS and need programmatic access to system network or configuration settings. The package is actively maintained, carries no known vulnerabilities, and has a permissive license. Install friction is moderate due to platform and compiled-dependency constraints, but these are inherent to macOS framework bindings and not a sign of poor maintenance.

## Install

pip install pyobjc-framework-systemconfiguration
uv add pyobjc-framework-systemconfiguration
poetry add pyobjc-framework-systemconfiguration

## Installing pyobjc-framework-SystemConfiguration

Before you install: Medium install friction due to platform-specific wheels (macOS only) and compiled dependencies on pyobjc-core and pyobjc-framework-Cocoa. Actively maintained with recent releases and no known vulnerabilities.

License in practice: MIT license permits use, modification, and distribution with minimal restrictions, making it suitable for both open-source and proprietary projects.

Quickstart:

pip install pyobjc-framework-systemconfiguration

from SystemConfiguration import SCNetworkReachability
# Access macOS network configuration APIs

macOS only; requires Python 3.10 or later; compiled extension dependencies require Xcode command-line tools or equivalent on macOS.

Verify before relying:

- Specific SystemConfiguration APIs exposed and their stability guarantees beyond Apple's framework documentation
- Performance characteristics when polling or monitoring system configuration changes
- Compatibility with non-Intel macOS architectures beyond the universal2 wheel support indicated

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 692.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

macos system configuration api, network settings python mac, pyobjc systemconfiguration, mac network configuration bindings, cocoa framework wrappers, macos system preferences access, macos-only, system-integration, network-config

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