Welcome to PyLucene

What is PyLucene ?

PyLucene is a Python extension for accessing Java Lucene™. Its goal is to allow you to use Lucene's text indexing and searching capabilities from Python. It is API compatible with Java Lucene version 8.9.0 as of June 22nd, 2021.

PyLucene is not a Lucene port but a Python wrapper around Java Lucene. PyLucene embeds a Java VM with Lucene into a Python process. The PyLucene Python extension, a Python module called lucene is machine-generated by JCC.

PyLucene is built with JCC, a C++ code generator that makes it possible to call into Java classes from Python via Java's Native Invocation Interface (JNI). Sources for JCC are included with the PyLucene sources.

See here for more information and documentation about PyLucene.

Requirements

PyLucene is supported on macOS, Linux, Solaris and Windows.

PyLucene requires Python 3.x (x >= 3), or Python version 2.x (x >= 3.5), and Java x (x >= 8). Building PyLucene requires GNU Make, a recent version of Ant capable of building Java Lucene and a C++ compiler. Use of setuptools is recommended.

See the JCC installation instructions for more information about building JCC from sources.

See the PyLucene installation instructions for more information about building PyLucene from sources.

Latest News

22 June 2021 - PyLucene 8.9.0 available

This release tracks Lucene Core's 8.9.0 release.
See PyLucene 8.9.0 CHANGES and JCC 3.10 CHANGES for details.
Source distributions are available here.

8 March 2021 - PyLucene 8.8.1 available

This release tracks Lucene Core's 8.8.1 release.
See PyLucene 8.8.1 CHANGES and JCC 3.9 CHANGES for details.
Source distributions are available here.

9 September 2020 - PyLucene 8.6.1 available

This release tracks Lucene Core's 8.6.1 release.
See PyLucene 8.6.1 CHANGES and JCC 3.8 CHANGES for details.
Source distributions are available here.

For all news items, see PyLucene News