Introduction

Before you can start writing Python code that runs on the Java Virtual Machine (JVM), you need to install Jython and ensure that a compatible version of Java is available on your system.

Unlike the standard Python interpreter (CPython), Jython depends on the Java Runtime Environment (JRE) or Java Development Kit (JDK). Once installed, Jython allows you to execute Python programs while taking advantage of Java libraries and the JVM platform.

In this tutorial, you'll learn:

  • What you need before installing Jython
  • How to install Java
  • How to download and install Jython
  • Configure environment variables
  • Verify the installation
  • Run your first Jython program
  • Common installation problems and solutions

This guide is suitable for beginners and works for Windows, macOS, and Linux.

System Requirements

Before installing Jython, make sure your computer meets the following requirements.

ComponentRequirement
Operating SystemWindows, macOS, or Linux
JavaJava Runtime Environment (JRE) or Java Development Kit (JDK)
RAM2 GB minimum (4 GB recommended)
Disk SpaceApproximately 200 MB
Internet ConnectionRequired for downloading Java and Jython

Step 1: Install Java

Jython requires Java because it runs on the Java Virtual Machine (JVM).

Check Whether Java Is Installed

Open a terminal (or Command Prompt on Windows) and run:

java -version

Example output:

openjdk version "17.0.8"
OpenJDK Runtime Environment
OpenJDK 64-Bit Server VM

If Java is installed, you should see version information similar to the example above.

If you receive an error such as:

'java' is not recognized as an internal or external command

or

command not found: java

install Java before proceeding.

Step 2: Download Jython

Download the latest stable Jython installer from the official Jython project website.

Choose the installer that matches your operating system.

Typical download options include:

  • Standalone installer (.jar)
  • Installer package
  • Source archive

For most users, the standalone installer is the easiest option.

Step 3: Install Jython on Windows

Run the Installer

If you downloaded the installer package, double-click it to launch the installation wizard.

If you downloaded the standalone JAR file, open Command Prompt and run:

java -jar jython-installer.jar

Replace jython-installer.jar with the actual filename if necessary.

Follow the Installation Wizard

During installation:

  • Accept the license agreement.
  • Choose the installation directory.
  • Select the standard installation type (recommended for beginners).
  • Complete the installation.

A typical installation path is:

C:\Jython

Step 4: Install Jython on macOS

Open the Terminal application.

Navigate to the folder containing the installer and run:

java -jar jython-installer.jar

Follow the on-screen prompts to complete the installation.

You can install Jython in your home directory or another preferred location.

Step 5: Install Jython on Linux

Open a terminal and navigate to the installer location.

Run:

java -jar jython-installer.jar

Complete the installation by following the prompts.

A common installation location is:

/opt/jython

or

/usr/local/jython

depending on your system configuration.

Step 6: Configure Environment Variables

Adding Jython to your system's PATH allows you to run the jython command from any terminal or command prompt.

Windows

  1. Open Environment Variables.
  2. Edit the Path system variable.
  3. Add the Jython bin directory.

Example:

C:\Jython\bin

Save the changes and restart Command Prompt.

macOS and Linux

Open your shell configuration file, such as .bashrc, .zshrc, or .profile, and add:

export PATH=$PATH:/opt/jython/bin

If Jython is installed elsewhere, replace /opt/jython/bin with the correct path.

Reload the shell configuration:

source ~/.bashrc

or

source ~/.zshrc

depending on the shell you use.

Step 7: Verify the Installation

After installation, verify that Jython is available.

Run:

jython --version

Example output:

Jython 2.7.x

You can also start the interactive interpreter:

jython

You should see a prompt similar to:

Jython 2.7.x on Java ...
>>>

Exit the interpreter by typing:

exit()

or by pressing:

Ctrl + D

on macOS/Linux, or

Ctrl + Z

followed by Enter on Windows.

Your First Jython Program

Create a file named:

hello.py

Add the following code:

print("Hello, Jython!")

Save the file.

Run it with:

jython hello.py

Expected output:

Hello, Jython!

Congratulations! Your first Jython program has executed successfully.

Running Jython Interactively

You can also use Jython as an interactive shell.

Start it:

jython

Then enter:

>>> print("Learning Jython")

Output:

Learning Jython

The interactive shell is useful for testing small snippets of code and experimenting with Java integration.

Testing Java Integration

One of Jython's biggest strengths is direct access to Java classes.

Create a file named date_example.py:

from java.util import Date

today = Date()

print(today)

Run:

jython date_example.py

If the current date and time are displayed, your Jython installation is correctly interacting with the Java runtime.

Directory Structure

A typical Jython installation includes:

Jython/
│
├── bin/
├── Demo/
├── Doc/
├── Lib/
├── registry
└── jython.jar

Folder Descriptions

FolderPurpose
binExecutable scripts
LibStandard Python libraries supported by Jython
DemoExample programs
DocDocumentation
jython.jarCore Jython runtime

Common Installation Errors

Java Not Found

Error:

java: command not found

Solution:

  • Install the JDK or JRE.
  • Ensure Java is added to your system PATH.

Jython Command Not Found

Error:

jython: command not found

Solution:

  • Confirm that the bin directory is included in the PATH.
  • Restart your terminal after updating environment variables.

Incorrect Java Version

Some older Jython releases may not work well with very recent Java versions.

If you encounter compatibility issues, consult the Jython documentation for supported Java versions.

Permission Denied (Linux/macOS)

Grant execute permission if required:

chmod +x jython

Best Practices After Installation

Once Jython is installed:

  • Keep Java updated with stable releases.
  • Organize your Jython projects into dedicated folders.
  • Use version control such as Git.
  • Separate Java libraries from project source files.
  • Test Java imports before starting larger projects.
  • Read release notes before upgrading Jython or Java.

Frequently Asked Questions (FAQ)

Do I need Python installed before using Jython?

No. Jython includes its own Python implementation and runs independently of CPython.

Do I need Java?

Yes. Jython requires a Java Runtime Environment (JRE) or Java Development Kit (JDK) because it runs on the JVM.

Can I install Jython alongside Python?

Yes. Jython and CPython can coexist on the same computer without conflicts.

Does Jython support Python 3?

No. The latest stable Jython release is based on Python 2.7 syntax.

Can I use pip with Jython?

Some pure Python packages may work, but packages that depend on CPython-specific C extensions generally are not compatible.

Conclusion

Installing Jython is straightforward once Java is available on your system. After downloading the installer, configuring your environment, and verifying the installation, you can begin writing Python code that runs directly on the Java Virtual Machine. This unique capability allows you to combine Python's simplicity with Java's extensive ecosystem, making Jython an excellent choice for enterprise applications, automation, and JVM-based development.

By following the steps in this guide, you'll have a working Jython environment and be ready to explore Java integration, object-oriented programming, and more advanced Jython features.

Jython installation guide for all platforms