Skip to main content

backend.ai-cli

Unified command-line interface for Backend.AI

How to adopt in CLI-enabled Backend.AI packages

An example setup.cfg in Backend.AI Manager:

[options.entry_points]
backendai_cli_v10 =
    mgr = ai.backend.manager.cli.__main__:main
    mgr.start-server = ai.backend.gateway.server:main

Define your package entry points that returns a Click command group using a prefix, and add additional entry points that returns a Click command using a prefix followed by a dot and sub-command name for shortcut access, under the backendai_cli_v10 entry point group.

Then add backend.ai-cli to the install_requires list.

You can do the same in setup.py as well.

Shell Tab Completion

The CLI provides built-in shell tab completion support for bash, zsh, and fish shells.

Quick Setup

# Show completion setup instructions
backend.ai completion --show

# Install completion automatically
backend.ai completion --shell bash  # Install to ~/.bashrc
backend.ai completion --shell zsh   # Install to ~/.zshrc
backend.ai completion --shell fish  # Install to fish completions

Manual Setup

If you prefer manual setup, you can add completion to your shell configuration:

Bash (~/.bashrc):

eval "$(_BACKEND_AI_COMPLETE=bash_source backend.ai)"

Zsh (~/.zshrc):

eval "$(_BACKEND_AI_COMPLETE=zsh_source backend.ai)"

Fish (~/.config/fish/config.fish):

backend.ai completion --shell fish | source

Features

Tab completion supports:

  • Commands: All available commands and subcommands
  • Options: Short and long flags with descriptions
  • Arguments: Context-aware argument completion where applicable
  • Help: Descriptions for commands and options

Examples

backend.ai <TAB>              # Show all available commands
backend.ai session <TAB>      # Show session subcommands
backend.ai session create <TAB>  # Show creation options
backend.ai --<TAB>            # Show global options

Metadata

Release files for backend.ai-cli 26.4.16

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

Source distribution (sdist)

Source distribution for backend.ai-cli 26.4.16
File Size Uploaded Provenance Actions
backend_ai_cli-26.4.16.tar.gz 13.0 kB Without provenance Details for backend_ai_cli-26.4.16.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for backend.ai-cli 26.4.16
File Interpreter ABI Platform Actions
backend_ai_cli-26.4.16-py3-none-any.whl Python 3 none any Details for backend_ai_cli-26.4.16-py3-none-any.whl

Total release size: 27.1 kB

Release files / backend_ai_cli-26.4.16.tar.gz

Download URL backend_ai_cli-26.4.16.tar.gz
Size 13.0 kB
Tags Source
SHA-256 checksum
How to use checksums
225ef73588c08fc673eaf964ad47fe0dbfd2cda6be66b2ba98d4b26dfdd2409d
BLAKE2b-256 checksum
How to use checksums
56293af167d4bea1dd7a7d22e623323fa2a1bea738efcb0449f588a19ceabaa1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.2.0 CPython/3.13.18

Release files / backend_ai_cli-26.4.16-py3-none-any.whl

Download URL backend_ai_cli-26.4.16-py3-none-any.whl
Size 14.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
37926dfa9f2922fb6e39c80df0e7618929050d3c4037321ab05eefb5be1f0059
BLAKE2b-256 checksum
How to use checksums
f4c8e72356c01576fce5cbe385a2089e47a9532e70bb2bd9a008b3b92a83173a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.2.0 CPython/3.13.18

Security for backend.ai-cli 26.4.16

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.

Release history Release notifications | RSS feed

This release

26.4.16 This release

2 release files No provenance

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