opensees-cli 0.1.0a3

Run OpenSees simulations in the cloud from the command line.

OpenSees CLI Documentation

Command-line interface for authentication and simulation runs.

Install

pip install opensees-cli

For local development from this repo:

pip install -e cli/

For development with test dependencies:

pip install -e "cli/[dev]"

Running tests

cd cli
pytest

Quick Start

# 1) Create account
ops auth signup --email [e-mail]

# 2) Confirm account
ops auth confirm --email [e-mail] --code 123456

# 3) Log in
ops auth login --email [e-mail]

# 4) Submit a simulation
ops run submit ./model.py --timeout 300 --wait

Top-Level Commands

ops version
ops status
ops quota
ops help

• version: print CLI version
• status: show account details, signup time, and quota (calls the API)
• quota: show your current run quota

Auth Commands

ops auth signup --email [e-mail]
ops auth confirm --email [e-mail] --code 123456
ops auth resend-code --email [e-mail]
ops auth login --email [e-mail]
ops auth logout
ops auth status
ops auth forgot-password --email [e-mail]
ops auth reset-password --email [e-mail] --code 123456
ops auth change-password
ops auth help

Run Commands

ops run submit ./model.py --timeout 120 --wait
ops run status <run_id>
ops run output <run_id>
ops run result <run_id>
ops run cancel <run_id>
ops run list --limit 20
ops run help

run submit options

• file (required positional): path to a .py simulation script
• --timeout, -t: max wall time per task in seconds (default 120). The API requires your monthly runtime remaining ≥ timeout × number of tasks. Runs above 900s use Fargate when configured; otherwise the 900s Lambda limit applies.
• --wait/--no-wait: stream output until completion (default --wait)

Validation enforced by CLI:

• file must exist
• file extension must be .py
• file size must be <= 200 KB

Common Workflows

Check account + quota

ops status
ops quota

Submit and monitor a run later

ops run submit ./model.py --no-wait
ops run status <run_id>
ops run output <run_id>
ops run result <run_id>

Reset password

ops auth forgot-password --email [e-mail]
ops auth reset-password --email [e-mail] --code 123456