Pyjnius depends on Cython and Java.

Installation on the Desktop

You need the Java 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.

  1. Download and install JDK and JRE:

  2. Edit your system and environment variables (use the appropriate Java version):
    Add to Environment Variables:
    • JDK_HOME: C:\Program Files\Java\jdk1.7.0_79\
    • PATH: C:\Program Files\Java\jdk1.7.0_79\jre\bin\server\
    Add to System Variables:
    • PATH: C:\Program Files\Java\jdk1.7.0_79\bin\`
  3. Download and install Microsoft Visual C++ Compiler for Python 2.7:

  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