jgo launches Java applications directly from Maven coordinates—no installation required. Just specify a Maven artifact identifier and an optional main class, and jgo resolves dependencies, materializes the environment including the version of Java needed, and runs your program.

# Run Jython REPL (latest version) jgo org.python:jython-standalone # Run with specific version jgo org.python:jython-standalone:2.7.3

• 🎯 Zero-configuration execution: Automatic Java download and version management thanks to cjdk integration
• 📦 Reproducible environments: jgo.toml project files with lock files (like package.json + package-lock.json)
• 🏗️ Three-layer architecture: Independently useful layers for Maven resolution, environment building, and execution
• 🐍 Pure Python resolver: No Maven installation required for basic operations
• 🔧 Powerful Python API: Fine-grained control over dependency resolution and execution

See docs/migration.md for migration from jgo 1.x.

# Run Jython REPL jgo org.python:jython-standalone # Run with arguments jgo org.python:jython-standalone -- -- script.py --verbose # Multiple artifacts with main class (use @ separator) jgo org.scijava:scijava-common+org.scijava:scripting-jython@ScriptREPL # Force update from remote repos jgo -u org.python:jython-standalone # Use specific Java version jgo --java-version 17 net.imagej:imagej # Print classpath without running jgo info classpath org.python:jython-standalone # Preview commands without executing (--dry-run) jgo --dry-run run org.scijava:parsington # See java command jgo --dry-run init org.python:jython-standalone # Preview jgo.toml

importjgo# Simple one-linerjgo.run("org.python:jython-standalone:2.7.3", app_args=["script.py"]) # Build environment without runningenv=jgo.build("org.python:jython-standalone") print(env.classpath) # List of JAR paths# Resolve dependenciescomponents=jgo.resolve("org.python:jython-standalone") forcompincomponents: print(f"{comp.groupId}:{comp.artifactId}:{comp.version}")

Create reproducible environments:

# jgo.toml [environment] name = "my-java-app" [dependencies] coordinates = ["net.imagej:imagej:2.15.0"] [entrypoints] default = "net.imagej.Main" [settings] cache_dir = ".jgo"# Local environment like .venv

# Run from current directory jgo # Creates .jgo/ with jars/ and jgo.lock.toml# Add to git: jgo.toml, jgo.lock.toml# Ignore: .jgo/

The jgo project began life as a shell script, but was later translated into Python, so that tools such as scyjava could leverage its environment-building capabilities.

uv tool install jgo

pip install jgo

conda install -c conda-forge jgo

git clone https://github.com/apposed/jgo uv tool install --with-editable jgo jgo

uv add jgo

pixi add jgo

Usage: jgo [OPTIONS] <endpoint> [-- JVM_ARGS] [-- APP_ARGS] Common Options: -v, --verbose Verbose output (-vv for debug, -vvv for trace) -u, --update Update cached environment --offline Work offline (don't download) --cache-dir PATH Override cache directory --java-version VERSION Force specific Java version -f FILE Use jgo.toml file Commands: run Run a Java application (default) info classpath Show classpath info deptree Show dependency tree info deplist Show flat dependency list info javainfo Show Java version requirements info entrypoints Show entrypoints from jgo.toml info versions List available artifact versions init Create new jgo.toml file version Display jgo version Endpoint Format: groupId:artifactId[:version][:classifier][@mainClass] Multiple artifacts: org.python:jython-standalone+org.slf4j:slf4j-simple Specify main class: org.scijava:scijava-common@ScriptREPL Auto-completion: Use simple class name (e.g., @ScriptREPL) and it will be auto-completed Full documentation: jgo --help 

Note the usage of the + syntax as needed to append elements to the classpath.

If you add scijava.public = https://maven.scijava.org/content/groups/public to the [repositories] section of your settings file (see Repositories below), you can also try:

• Is it fast? Endpoints are synthesized in a local cache under ~/.jgo. So invoking the same endpoint a second time is really quick.
• What does "no installation" mean? Classpath elements are hard-linked into ~/.jgo from ~/.m2/repository rather than copied, so the ~/.jgo folder has a tiny footprint even if you execute lots of different endpoints.
• What if an endpoint has a new version? Pass the -U flag to jgo to rebuild the endpoint. Note that unlike mvn, though, jgo does not check for updates otherwise.

You can configure the behavior of jgo using a settings file. The settings file is searched in the following locations (in order of precedence):

1. ~/.config/jgo.conf (XDG Base Directory standard - recommended)
2. ~/.jgorc (legacy location for backward compatibility)

You can define additional remote Maven repositories, from which artifacts will be retrieved. E.g.:

[repositories]scijava.public = https://maven.scijava.org/content/groups/public

If you need more control over where artifacts come from—for example, if you want to use your own remote Maven repository as a mirror of Maven Central—you can do it using Maven's usual ~/.m2/settings.xml; see Using Mirrors for Repositories.

You can also use the -r flag to pass additional repositories to individual invocations of jgo.

You can define shortcuts for launching commonly used programs:

[shortcuts]repl = imagej:org.scijava.script.ScriptREPL imagej = net.imagej:imagej fiji = sc.fiji:fiji:LATEST scifio = io.scif:scifio-cli

Shortcuts are substituted verbatim from the beginning of the endpoint, single-pass in the order they are defined. So e.g. now you can run:

jgo repl

Note that with the repl shortcut above, the main class (org.scijava.script.ScriptREPL) comes from a different artifact than the toplevel artifact (net.imagej:imagej). This is intentional, so that all of ImageJ, including all of the various SciJava scripting-<foo> plugins, is included in the classpath of the REPL.

There are a few configurable settings:

[settings]m2Repo = /path/to/.m2Repo (default ~/.m2/repository) cacheDir = /path/to/.jgo (default ~/.jgo) links = soft (options: hard, soft, none; default hard)

The jgo cache dir can also be set via the JGO_CACHE_DIR environment variable. The precedence of reading the cache dir, from highest to lowest:

• JGO_CACHE_DIR environment variable
• cacheDir in settings section in settings file
• default to ~/.cache/jgo

Maven has a feature whereby a project can override the versions of transitive (a.k.a. inherited) dependencies, via a <dependencyManagement> configuration. The problem is: a library may believe it depends on components at particular versions as defined by its <dependencyManagement>, but downstream projects which depend on that library will resolve to different versions. This means the library's actual dependencies differ from what it was built against! See this SO thread and this gist for full details.

By default, jgo works around this Maven limitation by adding all endpoints to the synthesized POM's <dependencyManagement> section using import scope. This ensures that the versions of transitive dependencies match those that each endpoint was actually built with, giving you the behavior you'd expect. In cases where multiple endpoints are concatenated via the + operator with conflicting dependency management, the earlier endpoints will win because they are declared earlier in the POM.

If you need to disable this behavior (rare), you can use --no-managed to get raw Maven transitive dependency resolution without the dependencyManagement workaround. The -m/--managed flags are still supported for compatibility, but managed mode is now the default.

See also issue #9 in the jgo issue tracker for more discussion of this issue.

• User Guide - Comprehensive guide covering installation, CLI reference, Python API, and common recipes
• Migration Guide - Upgrading from jgo 1.x to 2.0
• Architecture - Understanding the three-layer design
• API Reference - Use help(jgo) in Python for detailed API documentation
• TODO - Current development status and roadmap

jgo uses black for its code style.

After pip install tox, you can lint the code with:

tox -e lint

# Run all tests bin/test.sh # Run specific test file bin/test.sh tests/test_maven_basic.py # Run with coverage uv run pytest --cov=src/jgo tests/

• JBang
• mvnx
• JPM4J (discontinued)
• Mop (unmaintained)
• marun (unmaintained, Python 2 only)