The easiest way to install xlwings is via pip:

pip install xlwings

or conda:

conda install xlwings

Alternatively, it can be installed from source. From within the xlwings directory, execute:

python install


  • Windows: pywin32, comtypes

    On Windows, it is recommended to use one of the scientific Python distributions like Anaconda, WinPython or Canopy as they already include pywin32. Otherwise it needs to be installed from here.

  • Mac: psutil, appscript

    On Mac, the dependencies are automatically being handled if xlwings is installed with pip. However, the Xcode command line tools need to be available. Mac OS X 10.4 (Tiger) or later is required. The recommended Python distribution for Mac is Anaconda.

Optional Dependencies

  • NumPy
  • Pandas
  • Matplotlib
  • Pillow/PIL

These packages are not required but highly recommended as they play very nicely with xlwings.

Python version support

xlwings runs on Python 2.6-2.7 and 3.1+