ImJoy Plugin Engine for running Python plugins locally or remotely from ImJoy.io
Project description
ImJoy Plugin Engine
The plugin engine used for running python plugins in ImJoy (https://imjoy.io).
This library is mainly based on jupyter notebook server, with additional libraries and convenient settings.
Installation
-
If you don't have a conda environment, download and install Miniconda with Python 3.7 (or Anaconda with Python 3.7 if you prefer a full installation).
-
Start a Terminal(Mac and Linux) or Anaconda Prompt(Windows), then run the following command:
pip install -U imjoy[jupyter]
The above command will also install jupyter notebook and imjoy-elfinder.
- If you encountered any error related to
gitorpip, try to run :conda install -y git pipbefore the above command. (Otherwise, please check FAQs.)
Usage
To use it after the installation:
-
Run
imjoy --jupytercommand in a Terminal or Anaconda Prompt, and keep the window running. You will get a link that looks likehttp://localhost:8888/?token=caac2d7f2e8e0...ad871fefrom the terminal, please copy it for the next step. -
Go to https://imjoy.io, click the 🚀 icon located in the upper-right corner, select
Add Jupyter-Engineand paste the link you got previously, and connect to the plugin engine. Once connected, you can start to run python plugins through the plugin engine.
Please note that if you are trying to use the ImJoy Plugin Engine running on a remote server, please use the ImJoy web App served on your server (http://YOUR_REMOTE_IP:9527) instead of https://imjoy.io. This is because most browsers do not allow a web application served through https to connect to an unsecured server (your remote server). Alternatively, you can use a proxy to enable https for the plugin engine. Then you will be able to use it with https://imjoy.io.
Connecting to a ImJoy Engine Server
import webbrowser
from imjoy_rpc import connect_to_server, launch_plugin
def new_client_join(ws):
viewer = await ws.createWindow(src="https://kaibu.org")
async def main():
api = await connect_to_server(server_url="https://api.imjoy.io/")
api.on('join', new_client_join)
tk = await api.generate_token()
name = api.config['name']
token = tk['token']
url = f"https://imjoy.io/lite?server_url=https://api.imjoy.io&token={token}&name={name}"
print(url)
webbrowser.open(url)
More details and FAQs in Docs
Roadmap
You can track the progress of the project here: https://github.com/imjoy-team/ImJoy/projects/2
Issues
Please submit your bug report or feature request to ImJoy/issues
Development
- We use
blackfor code formatting.
git clone git@github.com:imjoy-team/ImJoy-Engine.git
# Enter directory.
cd ImJoy-Engine
# Install all development requirements and package in development mode.
pip3 install -r requirements_dev.txt
- Run
toxto run all tests and lint, including checking thatblackdoesn't change any files.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file imjoy-0.11.5.tar.gz.
File metadata
- Download URL: imjoy-0.11.5.tar.gz
- Upload date:
- Size: 23.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.1 importlib_metadata/4.0.1 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.9.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 04391414875809645f45f4a463040dcd53e91c63df3aa94c76605b25f2635e50 |
|
| MD5 | 13b2da923eb176b4649dba59aefa394a |
|
| BLAKE2b-256 | 714976c7aef44d85949cbe5c4c25fdbc6cf2efe1c8bbd4f1b88817096a5b7040 |
File details
Details for the file imjoy-0.11.5-py3-none-any.whl.
File metadata
- Download URL: imjoy-0.11.5-py3-none-any.whl
- Upload date:
- Size: 26.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.1 importlib_metadata/4.0.1 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.9.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 140416c4fa5a98e96044204fa9d0b4f18400aad4687d0fd35f56e1fab1901ec6 |
|
| MD5 | 0073c4a33d34aabbe894c5ef478889e5 |
|
| BLAKE2b-256 | cf421c86b231e6bc1d4c25dface33779c00c6767e0785e8cf9a8988e3ecdd307 |
