Skip to content


Repository files navigation

pySerial Build status Documentation


This module encapsulates the access for the serial port. It provides backends for Python running on Windows, OSX, Linux, BSD (possibly any POSIX compliant system) and IronPython. The module named "serial" automatically selects the appropriate backend.

BSD license, (C) 2001-2020 Chris Liechti <>


For API documentation, usage and examples see files in the "documentation" directory. The ".rst" files can be read in any text editor or being converted to HTML or PDF using Sphinx. An HTML version is online at


Examples and unit tests are in the directory examples.


pip install pyserial should work for most users.

Detailed information can be found in documentation/pyserial.rst.

The usual for Python libraries is used for the source distribution. Windows installers are also available (see download link above).


To install this package with conda run:

conda install -c conda-forge pyserial

conda builds are available for linux, mac and windows.