Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

OpenSees CLI Documentation

Command-line interface for authentication and simulation runs.

Install

pip install opensees_cli

The PyPI distribution name matches the import name: import opensees_cli and python -m opensees_cli.

Package page: pypi.org/project/opensees_cli.

PATH and the ops command

After install, pip places the ops launcher in a scripts directory (e.g. Scripts on Windows, bin on macOS/Linux). That folder might not be on your PATH, so ops may be missing in a new terminal.

  • On the first interactive run, the CLI can offer to add that folder to your PATH automatically.
  • To always run that step (for example on Windows), use:
python -m opensees_cli set_path

Answer Y when prompted. Open a new terminal afterward, then try ops version.

If ops is still not found, you can run the same program with:

python -m opensees_cli

To see the PATH offer again after you skipped it, delete the marker file ~/.opensees/path_fixed (on Windows: %USERPROFILE%\.opensees\path_fixed) and run python -m opensees_cli or python -m opensees_cli set_path.

Quick Start

# 1) Create account
ops auth signup --email you@example.com

# 2) Confirm account
ops auth confirm --email you@example.com --code 123456

# 3) Log in
ops auth login --email you@example.com

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

Top-Level Commands

ops set_path
ops version
ops status
ops quota
ops help
  • set_path: interactive prompt to add the ops launcher directory to your PATH (use python -m opensees_cli set_path if ops is not on PATH yet)
  • 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 you@example.com
ops auth confirm --email you@example.com --code 123456
ops auth resend-code --email you@example.com
ops auth login --email you@example.com
ops auth logout
ops auth status
ops auth forgot-password --email you@example.com
ops auth reset-password --email you@example.com --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 you@example.com
ops auth reset-password --email you@example.com --code 123456

Metadata

Release files for opensees-cli 0.1.0a7

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

Source distribution (sdist)

Source distribution for opensees-cli 0.1.0a7
File Size Uploaded Provenance Actions
opensees_cli-0.1.0a7.tar.gz 44.2 kB Without provenance Details for opensees_cli-0.1.0a7.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for opensees-cli 0.1.0a7
File Interpreter ABI Platform Actions
opensees_cli-0.1.0a7-py3-none-any.whl Python 3 none any Details for opensees_cli-0.1.0a7-py3-none-any.whl

Total release size: 85.3 kB

Release files / opensees_cli-0.1.0a7.tar.gz

Download URL opensees_cli-0.1.0a7.tar.gz
Size 44.2 kB
Tags Source
SHA-256 checksum
How to use checksums
760d450d766a03c9a0c06e7bf3ff9b13f144ec6db9b8ab7445b0a4f88f1fb482
BLAKE2b-256 checksum
How to use checksums
123c92f6a25fe6ecfb34456b500c3082ee6274d46b01521751b3d8f93b70b644
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.8

Release files / opensees_cli-0.1.0a7-py3-none-any.whl

Download URL opensees_cli-0.1.0a7-py3-none-any.whl
Size 41.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d08b57cfa21729b6ba130d852d175cf0693b4e88be530f5adae0c401dc6145ba
BLAKE2b-256 checksum
How to use checksums
0a242b5d8d9a2756137a928bccf5b2f4d28ca82ff8a0c312d8bf1273e8e6fa0e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.8

Security for opensees-cli 0.1.0a7

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.

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