PythonKit Documentation

To use PythonKit in your Swift project, add it as a dependency in your Package.swift manifest using the following URL and branch:

.package(url: "https://github.com/pvieito/PythonKit.git", branch: "main"),

If you are targeting macOS with the Hardened Runtime enabled, the Library Validation mechanism may prevent PythonKit from loading the Python framework if it is not signed by Apple or the same developer as your main process.

To resolve this, ensure you are properly signing and embedding the Python framework you intend to load, or consider disabling library validation if appropriate for your security model.

PythonKit allows you to import Python modules directly into Swift using Python.import("module_name"). Once imported, you can access Python attributes, methods, and properties as if they were native Swift objects.

import PythonKit

let sys = Python.import("sys")

print("Python \(sys.version_info.major).\(sys.version_info.minor)")
print("Python Version: \(sys.version)")
print("Python Encoding: \(sys.getdefaultencoding().upper())")

PythonKit attempts to find the most modern Python version available on your system at runtime. You can override this behavior using the following environment variables:

• PYTHON_VERSION: Force a specific Python version (e.g., 3 or 2.7).
• PYTHON_LIBRARY: Specify a specific Python library name or absolute path to the library file.

To debug library loading issues, set PYTHON_LOADER_LOGGING=TRUE to see the search paths attempted by PythonKit.