Metadata-Version: 2.4
Name: krow-sdk-install
Version: 0.8.12.11
Summary: CLI installer for krow-agent-sdk-runtime via Krow Cloud reverse proxy.
Project-URL: Homepage, https://krow.cn
Project-URL: Documentation, https://github.com/aullik5/krow-sdk-docs/blob/main/docs/runtime-install.md
Project-URL: Repository, https://github.com/aullik5/krow-sdk-docs
Project-URL: Issues, https://github.com/aullik5/krow-sdk-docs/issues
Author-email: Krow Team <support@krow.cn>
License: Proprietary
License-File: LICENSE
Keywords: cli,installer,krow,sdk
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Software Distribution
Requires-Python: >=3.11
Requires-Dist: httpx>=0.26
Provides-Extra: dev
Requires-Dist: build>=1.2; extra == 'dev'
Requires-Dist: hatchling>=1.21; extra == 'dev'
Requires-Dist: pytest-mock>=3.12; extra == 'dev'
Requires-Dist: pytest-timeout>=2.3; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Description-Content-Type: text/markdown

# Krow SDK Install CLI

> CLI installer for `krow-agent-sdk-runtime` via Krow Cloud reverse proxy (M9 v2).

## 用途

`krow-sdk-install` 是 Krow Agent SDK 的**私有 runtime wheel 安装器**：

```bash
pip install krow-agent-sdk           # 公开 SDK
krow-sdk-install --api-key sk-xxx    # 私有 runtime（走 Krow Cloud reverse proxy）
```

**整个过程不需要你接触 PyPI / GitHub PAT** — 客户端只与 `api.krow.cn` 一个 endpoint 通信。

## 工作流程

1. CLI 调 Krow Cloud `GET /sdk/runtime/pypi/simple/krow-agent-sdk-runtime/` 拉 PEP 503 index
2. Krow Cloud gateway 鉴权（Bearer `$KROW_API_KEY`）+ 套餐 entitlement + rate limit
3. CLI 选当前 host 的 wheel（`platform_tag` × `python_tag`），调 `GET /sdk/runtime/pypi/files/<wheel>`
4. CLI 校验 wheel SHA256 与 PEP 503 hash fragment 一致 → `pip install <wheel>` 本地

## 用法

```bash
# 标准用法（生产）
krow-sdk-install --api-key $KROW_API_KEY

# 用 staging endpoint（M9 W3 联调用）
krow-sdk-install --api-key $KROW_API_KEY --base-url https://api-staging.krow.cn

# 仅下载不装（air-gap 场景）
krow-sdk-install --api-key $KROW_API_KEY --download-only --output-dir ./wheels/

# dry-run（看会做什么但不真装）
krow-sdk-install --api-key $KROW_API_KEY --dry-run
```

## 详细文档

- [`runtime-install.md`](https://github.com/aullik5/krow-sdk-docs/blob/main/docs/runtime-install.md) — 用户安装指南
- [`api-reference.md`](https://github.com/aullik5/krow-sdk-docs/blob/main/docs/api-reference.md) — SDK API 手册

## License

Proprietary — 详见 [LICENSE](./LICENSE) + [EULA](https://github.com/aullik5/krow-sdk-docs/blob/main/docs/EULA.md)。
