opensees-cli 0.1.0a1

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/

Configure API URL (optional)

By default, the CLI uses the production API URL baked into the package.

To override (for dev/staging):

export OPENSEES_API_URL="https://your-api-id.execute-api.us-west-2.amazonaws.com/prod"

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 current login state and local config path
• 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 whoami
ops auth forgot-password --email [e-mail]
ops auth reset-password --email [e-mail] --code 123456
ops auth change-password
ops auth help

Notes:

• Password prompts are interactive and masked.
• Credentials are stored in ~/.ops/credentials.json.
• Access tokens are refreshed automatically when possible.

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 runtime in seconds (default 120, backend max 900)
• --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 auth whoami
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