Metadata-Version: 2.5
Name: v8x
Version: 0.1.70
Summary: The v8x CLI for Vantage Compute.
Author-email: jamesbeedy <james@vantagecompute.ai>
License: GPL-3.0
License-File: LICENSE
Requires-Python: >=3.12
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

The Vantage Compute command-line interface.

[![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/)

</div>

## Overview

v8x is a Python package that bundles the [v8xgo](https://github.com/vantagecompute/v8xgo) CLI binary for convenient installation via pip or uvx.

## Install

```bash
pip install v8x
```

Or run without installing:

```bash
uvx v8x --help
```

## Quick Start

1. Log in to Vantage:
```bash
v8x login
```

2. Create a cloud account for on-premises infrastructure:
```bash
v8x cloud account create mydatacenter-west --provider on_prem
```

3. Create a cluster:
```bash
v8x cluster create my-cluster \
  --app slurm-multipass \
  --cloud-account-name mydatacenter-west \
  --cluster-type slurm \
  --create-team
```

## Documentation

Full command reference and guides: https://docs.vantagecompute.ai/v8x

## Architecture

This package is a thin wrapper around the v8xgo Go binary. It contains:

- Zero Python runtime dependencies
- A platform-specific v8xgo binary bundled in the wheel
- An entry point that execs the binary, replacing the Python process

All CLI logic lives in [v8xgo](https://github.com/vantagecompute/v8xgo).

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