Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Build Status Python 3.6 License


OpenSPARKL Project Home

Console CLI interface for managing running SPARKL nodes.

Only supports Python 3.

Get the latest from releases.


Choose your Python 3 executable name by exporting the PYTHON= env var, then use make as follows:

  1. (Optional) export PYTHON=python (assuming your executable is python, default is python3).
  2. make deps to set up dependencies.
  3. make rel to create distribution in dist directory (use pip install to install it).


To run from the repo root, use python3 -m sparkl_cli. If installed, use sparkl.

Use sparkl -h to see help as follows:

usage: sparkl_cli [-h] [-v] [-a ALIAS] [-s SESSION] [-t TIMEOUT]

SPARKL command line utility.

positional arguments:
    active              list active services
    call                invoke a transaction or individual operation
    cd                  show or change current folder
    close               close connection
    connect             create or show connections
    elastic             push JSON to Elasticsearch
    listen              listen for events on any configuration object
    login               login user or show current login
    logout              logout user
    ls                  list content of folder or service
    mkdir               create new folder
    node                show node info (administrator only)
    object              get object JSON by name or id
    put                 upload XML source [or change] file
    render              transform source configuration or local file into html
    rm                  remove object
    service             start service implementation module
    session             show current session info
    source              view [and download] source configuration
    start               start a service
    stop                stop one or more services
    tree                show source in tree-like format
    undo                undo last change
    vars                set field variables

optional arguments:
  -h, --help            show this help message and exit
  -v, --version         show program's version number and exit
  -a ALIAS, --alias ALIAS
                        optional alias for multiple connections
  -s SESSION, --session SESSION
                        optional session id, defaults to invoking pid
  -t TIMEOUT, --timeout TIMEOUT
                        request timeout in seconds, default 0 means no timeout

Use 'sparkl_cli <cmd> -h' for subcommand help


  • To remove a global installation:
    sudo -H pip3 uninstall sparkl_cli
  • To remove a user installation:
    pip3 uninstall sparkl_cli
You can’t perform that action at this time.