Skip to main content

Developing Xircuits Core Features

Developing Xircuits Core Functions​

For most use cases installing via pip install xircuits should be enough. You can then add and modify the existing components using Python.

However if you would like to modify some of the Xircuits core functions (such as node and port logic) you may follow the following steps. Note that this is more advanced and require JavaScript / TypeScript knowledge.

Prerequisites​

Building Xircuits requires nodejs and yarn. The test nvm version is 14.15.3. You may also want to set yarn globally accessible by:

npm install --global yarn

Build​

git clone https://github.com/XpressAI/xircuits

Make and activate python env. You will need a Python 3.8 or above.

python -m venv venv
venv/Scripts/activate

Run the following commands to install the package in local editable mode and install xircuits into the JupyterLab environment.

# Install package in development mode
pip install -e .
# Link your development version of the extension with JupyterLab
jupyter labextension develop . --overwrite
# Enable the server extension
jupyter server extension enable xircuits

Running​

Start up xircuits using:

xircuits

Xircuits will open automatically in the browser.

Rebuild​

Rebuild Xircuits after making changes.

# Rebuild Typescript source after making changes
jlpm build
# Rebuild Xircuits after making any changes
jupyter lab build

Rebuild (Automatically)​

You can watch the source directory and run Xircuits in watch mode to watch for changes in the extension's source and automatically rebuild the extension and application.

# Watch the source directory in one terminal tab
jlpm run watch
# Run Xircuits in watch mode in another terminal tab
jupyter lab --watch

For more information on developing Jupyter extensions, check out the official Jupyterlab extension documentation.