Metadata-Version: 2.4
Name: v8x
Version: 0.1.13
Summary: The v8x CLI for Vantage Compute.
Author-email: jamesbeedy <james@vantagecompute.ai>
License: GPL-3.0
License-File: LICENSE
Requires-Python: >=3.12
Requires-Dist: aiohttp>=3.13.3
Requires-Dist: anyio>=4.12.1
Requires-Dist: gql>=4.0.0
Requires-Dist: httpx>=0.28.1
Requires-Dist: loguru>=0.7.3
Requires-Dist: pendulum>=3.2.0
Requires-Dist: py-buzz>=8.0.0
Requires-Dist: pydantic>=2.12.5
Requires-Dist: pyopenssl>=25.3.0
Requires-Dist: python-jose[cryptography]>=3.5.0
Requires-Dist: pyyaml>=6.0.3
Requires-Dist: qrcode>=8.0.0
Requires-Dist: requests-toolbelt>=1.0.0
Requires-Dist: rich>=14.3.2
Requires-Dist: ruamel-yaml>=0.19.1
Requires-Dist: snick>=3.0.0
Requires-Dist: textual>=7.5.0
Requires-Dist: typer>=0.21.1
Requires-Dist: vantage-sdkpy>=0.1.10
Requires-Dist: websockets>=16.0
Provides-Extra: dev
Requires-Dist: black>=26.1.0; extra == 'dev'
Requires-Dist: codespell>=2.4.1; extra == 'dev'
Requires-Dist: coverage[toml]>=7.13.3; extra == 'dev'
Requires-Dist: pyright>=1.1.408; extra == 'dev'
Requires-Dist: pytest-asyncio>=1.3.0; extra == 'dev'
Requires-Dist: pytest>=9.0.2; extra == 'dev'
Requires-Dist: respx>=0.22.0; extra == 'dev'
Requires-Dist: ruff>=0.15.0; extra == 'dev'
Description-Content-Type: text/markdown

<div align="center">
<a href="https://www.vantagecompute.ai/">
  <img src="https://vantage-compute-public-assets.s3.us-east-1.amazonaws.com/branding/vantage-logo-text-black-horz.png" alt="Vantage Compute Logo" width="100" style="margin-bottom: 0.5em;"/>
</a>
</div>

<div align="center">

# v8x
A modern Python command-line interface for interacting with Vantage Compute.

[![License](https://img.shields.io/badge/license-GPLv3-green.svg)](LICENSE)
[![Python](https://img.shields.io/badge/python-3.12+-blue.svg)](https://python.org)
[![PyPI](https://img.shields.io/pypi/v/v8x.svg)](https://pypi.org/project/v8x/)

![Build Status](https://img.shields.io/github/actions/workflow/status/vantagecompute/v8x/ci.yaml?branch=main&label=build&logo=github&style=plastic)
![GitHub Issues](https://img.shields.io/github/issues/vantagecompute/v8x?label=issues&logo=github&style=plastic)
![Pull Requests](https://img.shields.io/github/issues-pr/vantagecompute/v8x?label=pull-requests&logo=github&style=plastic)
![GitHub Contributors](https://img.shields.io/github/contributors/vantagecompute/v8x?logo=github&style=plastic)

</div>

## Overview

v8x provides a streamlined interface to authenticate with Vantage, discover and manage compute resources, and operate cloud or local environments from a single command surface.

Use the CLI for high-level workflows such as:

- logging in and managing profiles
- creating and managing clusters and deployments
- working with app, storage, and cloud account resources
- integrating Vantage operations into automation scripts and CI pipelines

## Getting Started

1) Login in Vantage
```bash
uvx v8x login
```

2) Create a Cloud Account that Represents your On-Premises infrastructure.
```bash
uvx v8x cloud account create mydatacenter-west --provider on_prem
```

3) Create your first cluster using multipass (works on arm64 and amd64)
```bash
uvx v8x cluster create slurm-multipass-demo-james \
  --app slurm-multipass \
  --cloud-account-name mydatacenter-west \
  --cluster-type slurm \
  --create-team
```

## Documentation

For full command reference, workflows, and operational guides, see:

- https://docs.vantagecompute.ai/v8x

## Support

- Issues: https://github.com/vantagecompute/v8x/issues
- Discussions: https://github.com/vantagecompute/v8x/discussions

## License

Copyright &copy; 2025 Vantage Compute Corporation

This project is licensed under the GPLv3 License. See [LICENSE](LICENSE) for details.

