orca logo

orca

OpenStack Rich Command-line Alternative — a unified CLI for managing OpenStack cloud infrastructure.

Highlights

60+ command groups covering every major OpenStack service (Keystone, Nova, Neutron, Cinder, Glance, Swift, Heat, Octavia, Designate, Barbican, Magnum, Gnocchi, Aodh, CloudKitty, Placement, Freezer)
Typed service layer — every resource flows through a typed *Service class with TypedDict models, catching field-name typos at mypy time
Rich terminal output — coloured tables, trees and progress bars powered by Rich
Multi-account profiles — named profiles, clouds.yaml and OS_* env var support, transparent token caching
Shell auto-completion — Bash, Zsh, and Fish, with per-profile resource caching
Orca-exclusive commands — overview, watch, doctor, audit, cleanup, export, find, ip-whois

Quick Start

pip install orca-openstackclient
orca setup           # interactive credential setup
orca server list     # list your VMs

From source (development):

git clone https://github.com/stackopshq/orca-cli.git
cd orca-cli
poetry install --with dev
poetry run orca --help

Requires Python 3.9 – 3.14.

Commands at a glance

Compute (Nova)

server · server bulk · flavor · keypair · aggregate · hypervisor · availability-zone · compute-service · server-group · usage · limits · event

Networking (Neutron)

network · floating-ip · security-group · subnet-pool · trunk · qos

Storage

volume · image (Glance) · object / container (Swift) · backup (Freezer)

Identity (Keystone)

project · user · role · domain · group · credential · application-credential · endpoint · endpoint-group · service · region · policy · trust · token · auth · access-rule · limit · registered-limit · catalog

Federation (Keystone)

identity-provider · federation-protocol · mapping · service-provider

Platform services

stack (Heat) · loadbalancer (Octavia) · zone / recordset (Designate) · secret (Barbican) · cluster (Magnum) · metric (Gnocchi) · alarm (Aodh) · rating (CloudKitty) · placement

Orca-exclusive

overview · watch · doctor · audit · cleanup · export · find · ip · quota · profile · setup

Documentation

Full documentation: stackopshq.github.io/orca-cli

Local preview:

poetry install --with docs
mkdocs serve

Release notes: see CHANGELOG.md.

Architectural decisions: docs/adr/.

License

Apache-2.0

Release files for orca-openstackclient 2.7.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 orca-openstackclient 2.7.0
File	Size	Uploaded
orca_openstackclient-2.7.0.tar.gz	313.4 kB	May 29, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for orca-openstackclient 2.7.0
File	Interpreter	ABI	Platform	Reset
orca_openstackclient-2.7.0-py3-none-any.whl 391.8 kB May 29, 2026	Python 3	none	any	Details

Total release size: 705.2 kB

Release files / orca_openstackclient-2.7.0.tar.gz

Download URL	orca_openstackclient-2.7.0.tar.gz
Size	313.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`3aa683584a44577f40ea3bffcd40bc8cc766ab48287b0bc962c3ec0909990c69`
BLAKE2b-256 checksum How to use checksums	`307016d02b0118491e817bc4dfa52bf46ae3d503a3989bbff9408ae77975d405`
Upload date	May 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.13`

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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/stackopshq/orca-cli
Publishing commit: github.com/stackopshq/orca-cli/tree/92d0a00185426c3654e8cf9eda29253220a672a5

Workflow

Publishing configuration: github.com/stackopshq/orca-cli/blob/92d0a00185426c3654e8cf9eda29253220a672a5/.github/workflows/publish.yml
Publishing logs: github.com/stackopshq/orca-cli/actions/runs/26655310064/attempts/1

Artifact

Subject: orca_openstackclient-2.7.0.tar.gz
SHA-256 checksum: 3aa683584a44577f40ea3bffcd40bc8cc766ab48287b0bc962c3ec0909990c69 Verifying attestations

Release files / orca_openstackclient-2.7.0-py3-none-any.whl

Download URL	orca_openstackclient-2.7.0-py3-none-any.whl
Size	391.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`e14915dafee3fe022e2fdc546ae00a3cd469de4e262eeeb789e0a8ae9a14cb16`
BLAKE2b-256 checksum How to use checksums	`ab15a792623813554c9f372bbd3b2c5ae4fcd8d621f2e7745cd5bcab8419deb6`
Upload date	May 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.13`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/stackopshq/orca-cli
Publishing commit: github.com/stackopshq/orca-cli/tree/92d0a00185426c3654e8cf9eda29253220a672a5

Workflow

Publishing configuration: github.com/stackopshq/orca-cli/blob/92d0a00185426c3654e8cf9eda29253220a672a5/.github/workflows/publish.yml
Publishing logs: github.com/stackopshq/orca-cli/actions/runs/26655310064/attempts/1

Artifact

Subject: orca_openstackclient-2.7.0-py3-none-any.whl
SHA-256 checksum: e14915dafee3fe022e2fdc546ae00a3cd469de4e262eeeb789e0a8ae9a14cb16 Verifying attestations