Emacs Python Development Environment
Clone or download
galaunay Merge pull request #1467 from galaunay/Fix-1425
Make sure completion is triggered for one characters variables
Latest commit 4e5469b Sep 16, 2018
Failed to load latest commit information.
.github Add explanations on the issue template Mar 31, 2018
docs Make adding shell completion candidates optional Sep 14, 2018
elpy Bump version: 1.23.0 → 1.24.0 Aug 31, 2018
scripts Avoid error in release script Jul 27, 2018
snippets/python-mode Return correct form of "super" depending on Python version Jan 20, 2016
test Merge pull request #1457 from galaunay/Add-1454 Sep 15, 2018
.bumpversion.cfg Bump version: 1.23.0 → 1.24.0 Aug 31, 2018
.coveragerc Add coveralls badge. Jun 26, 2014
.gitignore Added yapf as another formatter Nov 6, 2015
.travis.yml Add emacs 26.1 to travis (#1395) Jun 20, 2018
CONTRIBUTING.rst Switch URLs to readthedocs.io Apr 28, 2016
Cask Bump version: 1.23.0 → 1.24.0 Aug 31, 2018
LICENSE Add LICENSE file. Jan 28, 2013
MANIFEST.in Fix MANIFEST.in Sep 20, 2013
NEWS.rst Add 1.24.0 to NEWS.rst Aug 31, 2018
README.rst Add Debian (and derivatives) installation instructions. May 3, 2018
RELEASE.txt Use ./scripts/release to release the project Mar 30, 2018
elpy-django.el Typo fix Apr 20, 2018
elpy-pkg.el Bump version: 1.23.0 → 1.24.0 Aug 31, 2018
elpy-profile.el Add commands to profile python buffers Feb 27, 2017
elpy-refactor.el Fix some compilation warnings Feb 3, 2018
elpy-shell.el Revert "Fix echoing output in the minibuffer" Aug 7, 2018
elpy.el Merge pull request #1467 from galaunay/Fix-1425 Sep 16, 2018
requirements-dev.txt Update dependencies Sep 2, 2018
requirements.txt Update dependencies Sep 2, 2018
requirements3.txt Update dependencies Sep 2, 2018
setup.cfg Fix MANIFEST.in Sep 20, 2013
setup.py Remove importmagic Dec 10, 2017


Elpy, the Emacs Lisp Python Environment

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

https://secure.travis-ci.org/jorgenschaefer/elpy.png?branch=master https://coveralls.io/repos/jorgenschaefer/elpy/badge.png?branch=master


Elpy is fully documented at readthedocs.io:


Quick Installation

First, install the required Python packages::

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

One-line install: pip install jedi flake8 autopep8

Evaluate this in your *scratch* buffer:

(require 'package)
(add-to-list 'package-archives
             '("melpa-stable" . "https://stable.melpa.org/packages/"))

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.

Users of Debian ≥10 or Ubuntu ≥18.10 can skip the instructions above this line and may simply install Elpy and all of its recommended dependencies with the following command::

sudo apt install elpa-elpy

Elpy can then be activated by running M-x elpy-enable

Finally, to make this automatic, add the following to your .emacs:

;; (package-initialize) should already exist at the top of the init
;; file on Debian-derived systems, thus (elpy-enable) should be all
;; that is required.



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


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.

Thank You

If you would like to support this work, you can become a patreon:


Please note that this is completely voluntary, and does not make you more important than others when it comes to issues, feature requests or anything. I appreciate donations, but do not feel compelled to spend money, and do not feel bad if you don't.