Metadata-Version: 2.4
Name: runwhere
Version: 0.2.17
Summary: Runwhere.AI CLI — GPU job management tool
License: MIT
Keywords: gpu,ai,cloud,cli
Author: Runwhere.AI
Requires-Python: >=3.11
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Provides-Extra: dev
Requires-Dist: click (>=8.0)
Requires-Dist: httpx (>=0.27)
Requires-Dist: pathspec (>=0.12)
Requires-Dist: pydantic (>=2.0)
Requires-Dist: pytest (>=8.0) ; extra == "dev"
Requires-Dist: pytest-mock ; extra == "dev"
Requires-Dist: pyyaml (>=6.0)
Requires-Dist: respx (>=0.22) ; extra == "dev"
Requires-Dist: rich (>=13.0)
Requires-Dist: tomli-w (>=1.0)
Requires-Dist: websockets (>=12.0)
Project-URL: Documentation, https://docs.runwhere.cn
Project-URL: Homepage, https://runwhere.cn
Description-Content-Type: text/markdown

# runwhere — Runwhere.AI CLI

GPU 任务管理工具。通过 HTTP API 管理云端 GPU 资源和 AI 计算任务。

文档：<https://docs.runwhere.cn>

## 安装

```bash
pip install runwhere
```

## 使用

```bash
# 登录（Token 在控制台「API Keys」页创建；endpoint 可省略，默认官方地址）
runwhere login --endpoint https://app.runwhere.cn

# 比价
runwhere price summary                        # GPU 概览：型号/价格范围/库存
runwhere price list --gpu-type t4             # 指定 GPU 的全部报价
runwhere price recommend -f train.yaml        # 按 YAML 需求智能推荐

# 提交任务（本地文件先同步再提交）
runwhere sync -f train.yaml
runwhere submit -f train.yaml

# 查看与管理
runwhere get jobs                             # 任务列表
runwhere describe job <job-name>              # 任务详情
runwhere logs <job-name> -f                   # 跟踪日志
runwhere stop job <job-name>                  # 停止（notebook=挂起）
runwhere get usage                            # 用量与配额
runwhere whoami                               # 当前登录身份
```

`--json` 全局开关输出结构化 JSON（错误也走统一 envelope），适合脚本化：

```bash
runwhere --json price list --gpu-type t4
```

## 开发

```bash
pip install -e ".[dev]"
pytest tests/ -v
```

## 构建

```bash
bash scripts/build.sh
```

