JuliaPythonAdaptor

JuliaPythonAdaptor is a small Julia/Python package that helps you to create relocatable applications integrated with Julia and Python together.

The Julia programs using JuliaPythonAdaptor can be compiled by PackageCompiler into sysimages or executables that will work on another machine, if binary-compatible.

Note that your Python binaries are NOT bundled in the compiled julia files. You should also provide a proper Python environment for the target machines.

Motivation

At the current stage, a Julia programmer suffers from the following tasks:

1. Setting up a Python environment to work with Julia.

2. Reusing an existing Python/Julia environment from another language.

3. Distributing compiled Julia binaries that interoperate with Python packages.

This project aims at providing a user-friendly approach to address all above issues.

Target Uses

1. Software Integration

   If you want to make software that bundle Julia and Python together and make a separated environment, you might consider using this package or refer to the implementation.

2. Simple Python-Julia Interoperability

   If your activating environment contains julia and python, you don't need to consider details.

Installation

1. Install a julia (>= 1.6.1) distribution. Add it to $PATH if you want to avoid manual configurations.

2. Install a Python (3.7+) distribution. Add it to $PATH if you want to avoid manual configurations.

3. For the Python distribution: pip install https://github.com/thautwarm/JuliaPythonAdaptor.jl or pip install JuliaPythonAdaptor

   For the Julia distribution: julia -e "using Pkg; Pkg.add(\"JSON\", \"JuliaPythonAdaptor\")"

Usage

For relocatability, you might add the following environment variables:

Then, if you call Python from Julia, import JuliaPythonAdaptor before you import PythonCall. If you call Julia from Python, import JuliaPythonAdaptor before you import juliacall.

I use PyCall, how to use this package?

PyCall is a great package for Julia to call Python, but it so far does not consider much about relocatability and environment separation.

Please refer to these detailed instructions from PyCall to PythonCall. They will help you with migrating your codebase.

Contributions

PRs and issues are welcome.

Besides, this project leverages the mechanism provided by PythonCall.jl, CondaPkg.jl, MicroMamba.jl and pyjuliapkg. You might also consider contributing to them.