Skip to main content

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).

Metadata

Release files for ibee-cli 0.5.0

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

Source distribution (sdist)

Source distribution for ibee-cli 0.5.0
File Size Uploaded Provenance Actions
ibee_cli-0.5.0.tar.gz 51.5 kB With provenance Details for ibee_cli-0.5.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for ibee-cli 0.5.0
File Interpreter ABI Platform Actions
ibee_cli-0.5.0-py3-none-any.whl Python 3 none any Details for ibee_cli-0.5.0-py3-none-any.whl

Total release size: 101.3 kB

Release files / ibee_cli-0.5.0.tar.gz

Download URL ibee_cli-0.5.0.tar.gz
Size 51.5 kB
Tags Source
SHA-256 checksum
How to use checksums
56d7f0921838fca38d78f08ac305372b269160c4097536272ce75af9c9fde074
BLAKE2b-256 checksum
How to use checksums
caddafe349ed1ebc2fbce57a193f2a4ccb9aea5f034916f83862c6ab9808bd20
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 18, 2026.

Transparency log

Release files / ibee_cli-0.5.0-py3-none-any.whl

Download URL ibee_cli-0.5.0-py3-none-any.whl
Size 49.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
842e572db5d19710c0b8e28a9d83a88128b56dba74aec187f366e500610db194
BLAKE2b-256 checksum
How to use checksums
07ecda0b55d010904fd859ce0459a50f868ce953c2ef39d6b0b1d22df65a00e2
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 18, 2026.

Transparency log

Security for ibee-cli 0.5.0

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.

Select from 2 files

Attestation for ibee_cli-0.5.0.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 18, 2026.

Transparency log

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