Emacs Python Development Environment

License: GPL-3.0

Language: Emacs Lisp

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.


Elpy is fully documented at

Quick Installation

Python packages

First, install the required Python packages::

# Completion and code navigation
pip install jedi
# Code checks
pip install flake8
# Automatic formatting (PEP8, Yapf or Black)
pip install autopep8
pip install yapf
pip install black

One-line install: pip install jedi flake8 autopep8 black yapf

With use-package

(use-package elpy
  :ensure t

Or if you want to defer Elpy loading:

(use-package elpy
  :ensure t
  :defer t
  (advice-add 'python-mode :before 'elpy-enable))

Manually from Melpa

Evaluate this in your *scratch* buffer:

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

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.

Elpy can then be activated by running M-x elpy-enable. This can be made automatic by adding the following to your .emacs:


From apt (Debian ≥10 an Ubuntu ≥18.10)

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. This can be made automatic by adding 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.

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.

Project Statistics

Sourcerank 9
Repository Size 2.66 MB
Stars 1,392
Forks 179
Watchers 72
Open issues 291
Dependencies 13
Contributors 56
Tags 66
Last updated
Last pushed

Top Contributors See all

Jorgen Schäfer galaunay rgemulla Chillar Anand Daniel Gopar Georg Brandl Sam Steingold gaetano-guerriero Nicholas D Steeves Chris Latham Hong Xu fleimgruber teoric Alex Bennée Eric Hanchrow George Kettleborough Peter Vasil Craig MacEachern Clément Pit-Claudel Dennis Brakhane

Packages Referencing this Repo

Tombstone package for elpy to not break accidental dependencies
Latest release 1.999 - Updated - 1.39K stars

Recent Tags See all

1.29.1 April 15, 2019
1.29.0 April 14, 2019
1.28.0 December 28, 2018
1.27.0 December 02, 2018
1.26.0 November 03, 2018
1.25.0 October 05, 2018
1.24.0 August 31, 2018
1.23.0 July 27, 2018
1.22.0 June 29, 2018
1.21.0 May 25, 2018
1.20.0 April 27, 2018
1.19.0 March 30, 2018
1.18.0 January 28, 2018
1.17.0 October 29, 2017
1.16.1 September 22, 2017

Interesting Forks See all

Emacs Python Development Environment
Emacs Lisp - GPL-3.0 - Last pushed - 1 stars - 1 forks
Emacs Python Development Environment
GPL-3.0 - Published - 1 stars

Something wrong with this page? Make a suggestion

Last synced: 2019-04-24 07:18:42 UTC

Login to resync this repository