PyJNIus depends on Cython and Java Development Kit (includes Java Runtime Environment).

Installation on GNU/Linux distributions

You need GNU Compiler Collection (GCC), the JDK and JRE installed (openjdk will do), and Cython. Then, just type:

sudo python install

If you want to compile the extension within the directory for any development, just type:


You can run the tests suite to make sure everything is running right:

make tests

Installation for Android

To use pyjnius in an Android app, you must include it in your compiled Python distribution. This is done automatically if you build a Kivy app, but you can also add it to your requirements explicitly as follows.

If you use buildozer, add pyjnius to your requirements in buildozer.spec:

requirements = pyjnius

If you use python-for-android directly, add pyjnius to the requirements argument when creating a dist or apk:

p4a apk --requirements=pyjnius

Installation for Windows

Python and pip must be installed and present in PATH environment variable.

  1. Download and install JDK containing JRE:

  2. Edit your system and environment variables (use the appropriate Java bitness and version in paths):

    Add to Environment Variables:

    • JAVA_HOME: C:\Program Files\Java\jdk1.7.0_79\bin

    • PATH: C:\Program Files\Java\jdk1.7.0_79\jre\bin\server contains jvm.dll necessary for importing and using PyJNIus.


      set PATH=%PATH%;C:\Program Files\Java\jdk1.7.0_79\jre\bin\server

    Add to System Variables or have it present in your PATH:
    • PATH: C:\Program Files\Java\jdk1.7.0_79\bin`
  3. Download and install C compiler:

    1. Microsoft Visual C++ Compiler for Python 2.7:

    2. MinGWPy for Python 2.7:

    3. Microsoft Visual C++ Build Tools (command-line tools subset of Visual Studio) for Python 3.5 and 3.6:

    For other versions see Python’s Windows Compilers wiki.

  4. Update pip and setuptools:

    python -m pip install --upgrade pip setuptools
  5. Install Cython:

    python -m pip install --upgrade cython
  6. Install Pyjnius:

    pip install pyjnius


    In case of MinGWPy’s GCC returning a CreateProcess failed: 5 error you need to run the command prompt with elevated permissions, so that the compiler can access JDK in C:\Program Files\Java\jdkx.y.z_b or C:\Program Files (x86)\Java\jdkx.y.z_b.