IBEE Solutions CLI
Official command-line interface for the IBEE Solutions cloud platform, built on the
ibee Python SDK. Each command makes one
SDK call and prints the server's answer; the server decides prices, eligibility,
limits and states.
Installation
pip install ibee-cli
Requires Python 3.10+.
Authentication
Create an API token in the portal under Settings > API Tokens, then:
export IBEE_TOKEN="ibee_prod_key_xxxxxxxxxxxx"
export IBEE_WORKSPACE_ID="710995"
Both can also be passed per command with --token and --workspace.
Usage
ibee compute sites
ibee compute plans --vm-type cloud --site-id SITE_ID
ibee compute images --vm-type cloud --site-id SITE_ID
ibee vms create web-1 --site-id SITE_ID --plan-id PLAN_ID --template-id IMAGE_ID \
--ssh-key-file ~/.ssh/id_ed25519.pub --wait
ibee vms list
ibee vms get VM_ID
ibee vms stop VM_ID --wait
ibee vms delete VM_ID --yes
ibee ops wait OPERATION_ID
ibee vpcs list
ibee reserved-ips list
ibee firewalls list
ibee load-balancers list
ibee block-storage list
ibee buckets list
ibee cdn list
ibee secrets stores list
ibee billing eligibility --resource-type cpu_vm
ibee --help and ibee GROUP --help list every command. gpus takes the same
commands as vms. Until the server resolves VM SKUs itself, vms/gpus create fills
CPU, RAM, disk and OS from the plan and the image and sends the plan's billing SKU for
--billing-term (see the SDK's held.py).
Global options
| Option | Environment variable | Meaning |
|---|---|---|
--token |
IBEE_TOKEN (or IBEE_API_TOKEN) |
API token |
--workspace, -w |
IBEE_WORKSPACE_ID |
Workspace ID |
--dev |
IBEE_ENV=dev |
Use the development environment |
--base-url |
IBEE_BASE_URL, IBEE_ENDPOINT |
Custom API endpoint |
-o, --output |
IBEE_OUTPUT |
table, json, yaml or id |
--json |
Same as -o json |
|
--yes, -y |
IBEE_ASSUME_YES=1 |
Answer yes to every confirmation |
The endpoint is chosen in this order: --base-url, IBEE_BASE_URL, IBEE_ENDPOINT,
--dev, IBEE_ENV; the default is production, https://api.ibee.ai/v1. Without
-o, each command keeps its usual format (tables for most lists, JSON for single
resources).
Errors
Every error prints the HTTP status and the server's fields as sent:
Error: HTTP 402
code: billing_denied
reason: resource_limit_reached
message: -
request_id: 6f1c2e...
admission_context_id: adm_...
With -o json the same fields, plus the raw body, are printed on stderr as
{"error": {...}}.
Exit codes
| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | Failed, cancelled or timed-out operation (--wait), declined confirmation, or another error |
| 2 | Usage or configuration error (missing token or workspace, unsafe endpoint, token for the other environment); nothing was sent |
| 3 | --wait reached --timeout while the operation was still running; resume with ibee ops wait OPERATION_ID |
| 4 | Network error (no HTTP answer) |
| 10, 11, 12, 13, 14 | HTTP 400, 401, 402, 403, 404 |
| 15, 16, 17, 18 | HTTP 409, 422, 423, 429 |
| 19 | HTTP 5xx |
Retries and idempotency keys
The SDK retries reads on 429, 502, 503 and 504, and writes that carry an idempotency
key on 429 and 503, never on a billing or admission answer. Write commands that take
--idempotency-key KEY send it unchanged (without one the SDK sends a random key);
after a retryable failure the CLI prints Retry safely with: --idempotency-key KEY so
the command can be repeated without doing the write twice. --wait polls the
operation every --poll-interval seconds (default 5) for up to --timeout seconds
(default 1200).
Related
- Python SDK:
pip install ibee - API documentation
Metadata
Release files for ibee-cli 0.5.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| ibee_cli-0.5.1.tar.gz | 51.9 kB | With provenance | Details for ibee_cli-0.5.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| ibee_cli-0.5.1-py3-none-any.whl | Python 3 | none | any | Details for ibee_cli-0.5.1-py3-none-any.whl |
Total release size: 101.8 kB
Release files / ibee_cli-0.5.1.tar.gz
| Download URL | ibee_cli-0.5.1.tar.gz |
|---|---|
| Size | 51.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3b22ee5c8ab2b827726d0b5d48f965828e84263fb353e805d34852b96b877a35
|
|
BLAKE2b-256 checksum How to use checksums |
f8825655fd4c31b3b4db42d30798a3c20560d880eb479ab109fdd538a2f8f40b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.
Transparency logRelease files / ibee_cli-0.5.1-py3-none-any.whl
| Download URL | ibee_cli-0.5.1-py3-none-any.whl |
|---|---|
| Size | 49.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f92cdc906e83b898a9f808ad7cff2611dd7652c731ff90ffacb0c5a39a311a16
|
|
BLAKE2b-256 checksum How to use checksums |
132ab0f587ba6b002b5c6956e3c8b24b3d84d204b77cf1824fee247afe8d0e87
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.
Transparency logSecurity for ibee-cli 0.5.1
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.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for ibee_cli-0.5.1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.
Transparency logA 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.