phyware CLI — Getting Started¶
Overview¶
phyware is the unified command-line interface for all PhyWare products. It follows an Azure-CLI-style <group> <resource> <verb> command structure, giving a consistent experience across PhyCloud, PhyComp, and future PhyWare services.
Installation¶
# Download the latest binary for your platform
curl -sSfL https://releases.phyware.io/phyware/install.sh | sh
# Or install from source (requires Rust ≥ 1.75)
cargo install --git https://github.com/chrisherczeg/PhyWare phyware
Verify:
Quick Start¶
# 1. Authenticate (device-code flow)
phyware auth login --host https://cloud.phyware.io
# 2. Verify the hash-chain of your dataset
phyware cloud verify --tenant-id ten_abc123
# 3. Ingest your first event
phyware cloud events send --source-id src_xyz --payload '{"temperature":22.5}'
Configuration¶
| Environment Variable | Description | Default |
|---|---|---|
PHYCLOUD_URL | PhyCloud API base URL | http://localhost:8000 |
PHYCLOUD_API_KEY | PhyCloud API key (PAT or session) | — |
PHYCOMP_URL | PhyComp API base URL | http://localhost:8001 |
PHYCOMP_API_KEY | PhyComp API key | — |
Command Groups¶
| Group | Description |
|---|---|
cloud | Data ingestion, verification, tenants, keys, licenses |
comp | Compliance rules, violations, reports, evaluation |
users | User management (invite, list, get, deactivate) |
auth | Authentication (login, logout, status, token, …) |
commands | CLI metadata — machine-readable command catalog |