Skip to main content

Accelerator Terminal Client and Python API

This package provides:

  • A command-line client (accli) for interacting with the Accelerator.
  • A Python API via the accli package.

Both interfaces communicate with the Accelerator’s REST API, implemented in the Control Services Backend.


🔐 Authentication

This client uses device authentication via Auth0.

  • **OAuth Flow **: Device Authorization Flow
  • Token Validity: 7 days
  • Access Control: Role-Based Access Control (RBAC) with stateless tokens
  • Grants: Limited and scoped

📖 User Guide

✅ Requirements

  • Python >= 3.8

📦 Installation

No Python install required. Run the appropriate command for your system:

Linux / macOS:

curl -fsSL https://raw.githubusercontent.com/iiasa/accli/master/scripts/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/iiasa/accli/master/scripts/install.ps1 | iex

Option 2: Via PIP

pip install accli --user

▶️ Usage

As a Python Module

python -m accli

As an Executable

After installation, the executable might not be in your system PATH. You may see a warning like this:

WARNING: The script accli.exe is installed in 'C:\Users\<user>\AppData\Roaming\Python\Python311\Scripts' which is not on PATH.
Consider adding this directory to PATH or, if you prefer to suppress this warning, use --no-warn-script-location.

To resolve this, add the script's path to your system's environment variables:

Note: On Linux/macOS, you may need to prefix the command with ./, and on Windows, with .\.

🔍 Help Command

accli --help

Sample Output:

Usage: accli [OPTIONS] COMMAND [ARGS]...

📋 Jobs

List root jobs, newest first, with each job's type (standalone, children, callback or children+callback), its own status and the status of its whole graph:

accli jobs my-project                       # latest 10
accli jobs my-project -n 50
accli jobs my-project -s failed             # graphs with a failed job
accli jobs my-project -s processing,error

--status filters on the graph status: processing (or active), error (or failed) and done. A standalone job counts by its own status.

Show a job's status and details. For a job holding children or callbacks, Graph status covers the jobs below it (the same as GRAPH in accli jobs) and each one is listed; any job also links to the pipeline it is part of. Read a job's output with accli logs <project> <job>:

accli job my-project 1234
accli job my-project 1234 --json

👩‍💻 Developer Guide

Handling self-signed certificates

Import the certificates from accelerator_service into the Windows Root store (auto-elevates to Administrator if needed):

cd <path to>/accelerator_service/scripts
.\import_certs_certutil.ps1

🛠 Build & Upload

Follow the official Python packaging tutorial:
Packaging Projects – Python.org

🚀 Release Process

  1. Update the version in accli/_version.py

  2. Tag the release:

    python scripts/tag.py
    
  3. Build the package:

    python -m build
    
  4. Upload to PyPI:

    twine upload -r pypi -u __token__ -p <password-or-token> ./dist/*
    

Metadata

Release files for accli 2.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for accli 2.1.2
File Size Uploaded Provenance Actions
accli-2.1.2.tar.gz 66.8 kB Without provenance Details for accli-2.1.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for accli 2.1.2
File Interpreter ABI Platform Actions
accli-2.1.2-py3-none-any.whl Python 3 none any Details for accli-2.1.2-py3-none-any.whl

Total release size: 131.2 kB

Release files / accli-2.1.2.tar.gz

Download URL accli-2.1.2.tar.gz
Size 66.8 kB
Tags Source
SHA-256 checksum
How to use checksums
28f490eeae6fa1d47e8b46079616f92b8bd471671d9422cedb0915d0ea3996d2
BLAKE2b-256 checksum
How to use checksums
91b30318abaf7a5a788a1394d4d332339c9e988b08dc9c12630ac41836a973d6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.18

Release files / accli-2.1.2-py3-none-any.whl

Download URL accli-2.1.2-py3-none-any.whl
Size 64.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4691b03de56e78c8351c7a36b5e479e99a61f2c964f8bb3b12040308743a58c0
BLAKE2b-256 checksum
How to use checksums
95dd4dd4640ba45dbc0c34070eb4ce5e3f7207a4c675733c7c8dafb1636e3109
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.18

Security for accli 2.1.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

2.1.2 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page