Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Emacs Python Development Environment
Emacs Lisp Python Shell
Latest commit 4c03853 @jorgenschaefer Default to default-directory as project root in elpy-find-file
If elpy-project-root did not find the project root, the previous
default would cause an error. This workaround at least gives a basic
find file functionality.


Elpy, the Emacs Lisp Python Environment

Elpy is an Emacs package to bring powerful Python editing to Emacs. It combines a number of other packages, both written in Emacs Lisp as well as Python.


Elpy is fully documented at

Quick Installation

First, install the required Python packages::

# Either of these
pip install rope
pip install jedi
# flake8 for code checks
pip install flake8
# importmagic for automatic imports
pip install importmagic
# and autopep8 for automatic PEP8 formatting
pip install autopep8
# and yapf for code formatting
pip install yapf

Evaluate this in your *scratch* buffer:

(require 'package)
(add-to-list 'package-archives
             '("elpy" . ""))

Then run M-x package-refresh-contents to load the contents of the new repository, and M-x package-install RET elpy RET to install elpy.

Finally, add the following to your .emacs:




For questions regarding Elpy, do not hesitate to open an issue on github or visit us on IRC, channel #emacs-elpy on


This project is free software: You can redistribute it and/or modify it under the terms of the GNU General Public License, either version 3 of the License, or (at your option) any later version.

Something went wrong with that request. Please try again.