Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
June 21, 2023 19:06
September 16, 2023 21:41
September 22, 2023 21:29
September 5, 2022 17:31
September 16, 2023 21:41
March 22, 2023 00:47
December 12, 2020 12:45

Jedi - an awesome autocompletion, static analysis and refactoring library for Python

The percentage of open issues and pull requests The resolution time is the median time an issue or pull request stays open. Tests PyPI Downloads

Jedi is a static analysis tool for Python that is typically used in IDEs/editors plugins. Jedi has a focus on autocompletion and goto functionality. Other features include refactoring, code search and finding references.

Jedi has a simple API to work with. There is a reference implementation as a VIM-Plugin. Autocompletion in your REPL is also possible, IPython uses it natively and for the CPython REPL you can install it. Jedi is well tested and bugs should be rare.

Jedi can currently be used with the following editors/projects:

and many more!

There are a few language servers that use Jedi:

Here are some pictures taken from jedi-vim:

Completion for almost anything:


Get the latest version from github (master branch should always be kind of stable/working).

Docs are available at Pull requests with enhancements and/or fixes are awesome and most welcome. Jedi uses semantic versioning.

If you want to stay up-to-date with releases, please subscribe to this mailing list: To subscribe you can simply send an empty email to

Issues & Questions

You can file issues and questions in the issue tracker <>. Alternatively you can also ask on Stack Overflow with the label python-jedi.


Check out the docs.

Features and Limitations

Jedi's features are listed here: Features.

You can run Jedi on Python 3.6+ but it should also understand code that is older than those versions. Additionally you should be able to use Virtualenvs very well.

Tips on how to use Jedi efficiently can be found here.


You can find a comprehensive documentation for the API here.

Autocompletion / Goto / Documentation

There are the following commands:

  • jedi.Script.goto
  • jedi.Script.infer
  • jedi.Script.complete
  • jedi.Script.get_references
  • jedi.Script.get_signatures
  • jedi.Script.get_context

The returned objects are very powerful and are really all you might need.

Autocompletion in your REPL (IPython, etc.)

Jedi is a dependency of IPython. Autocompletion in IPython with Jedi is therefore possible without additional configuration.

Here is an example video how REPL completion can look like. For the python shell you can enable tab completion in a REPL.

Static Analysis

For a lot of forms of static analysis, you can try to use jedi.Script(...).get_names. It will return a list of names that you can then filter and work with. There is also a way to list the syntax errors in a file: jedi.Script.get_syntax_errors.


Jedi supports the following refactorings:

  • jedi.Script.inline
  • jedi.Script.rename
  • jedi.Script.extract_function
  • jedi.Script.extract_variable

There is support for module search with, and project search for The way to search is either by providing a name like foo or by using dotted syntax like Additionally you can provide the API type like class There are also the functions jedi.Script.complete_search and jedi.Project.complete_search.


There's a pretty good and extensive development documentation.


The test suite uses pytest:

pip install pytest

If you want to test only a specific Python version (e.g. Python 3.8), it is as easy as:

python3.8 -m pytest

For more detailed information visit the testing documentation.


Thanks a lot to all the contributors!