Welcome to Python.NET’s documentation!

Python.NET (pythonnet) is a package that gives Python programmers nearly seamless integration with the .NET 4.0+ Common Language Runtime (CLR) on Windows and Mono runtime on Linux and OSX. Python.NET provides a powerful application scripting tool for .NET developers. Using this package you can script .NET applications or build entire applications in Python, using .NET services and components written in any language that targets the CLR (C#, VB.NET, F#, C++/CLI).

Note that this package does _not_ implement Python as a first-class CLR language - it does not produce managed code (IL) from Python code. Rather, it is an integration of the CPython engine with the .NET or Mono runtime. This approach allows you to use CLR services and continue to use existing Python code and C-API extensions while maintaining native execution speeds for Python code. If you are interested in a pure managed-code implementation of the Python language, you should check out the IronPython project.

Python.NET is currently compatible and tested with Python releases from 3.7 onwards.

Current releases are available on PyPi and Nuget.org.

To subscribe to the Python.NET mailing list or read the online archives of the list, see the mailing list information page. Use the Python.NET issue tracker to report issues.

Contents:

• Embedding .NET into Python
  • Getting Started
  • Interacting with .NET
  • Advanced Usage
  • Type Conversion
• Embedding Python into .NET
  • Passing C# Objects to the Python Engine
• Codecs
  • Codec priorities
• Python Reference
  • Runtime loading and configuration
• C# Reference

Indices and tables

• Index

• Module Index

• Search Page

License

Python.NET is released under the open source MIT License. A copy of the license is included in the distribution, or you can find a copy of the license online.

.NET Foundation

This project is supported by the .NET Foundation.