gherkai-runtime
gherkai 的运行时装配层：拉起两个 AI 引擎的 worker、解析云端资源名与网络、组装并推进一次 run，执行调度交给核心库 https://pypi.org/project/gherkai-core/ 。它是 gherkai 命令行与 AWS 部署包依赖的库，一般不直接安装——要运行测试请装命令行包 gherkai。要做另一个前端（Web 界面、自建调度服务、把执行嵌进现有平台）时才直接用它。
安装
uv add gherkai-runtime # 或 pip install gherkai-runtime；需 Python ≥ 3.13
uv add 'gherkai-runtime[aws]' # 用到云端后端（DynamoDB / S3 / Fargate）时需要
最小用法
from pathlib import Path
from gherkai_runtime import compose
features = [compose.load_feature(Path("features/checkout.feature"))]
engines = compose.build_engines(region="us-east-1") # 本机 worker 子进程
resolver = compose.make_resolver(engines)
# 接着把 features 分组成 job、连同 resolver 交给 gherkai_core.schedule.schedule(...) 执行
分组到执行的完整用法见核心库的页面：https://pypi.org/project/gherkai-core/ 。
主要模块：
| 模块 | 提供什么 |
|---|---|
gherkai_runtime.compose |
读 .feature、生成 run 身份、拉起本机或 Fargate 引擎 worker、选结果落点、解析云端资源名与网络、查引擎能力 |
gherkai_runtime.names |
云端资源名、SSM 参数路径、worker 镜像 tag 的唯一命名实现 |
gherkai_runtime.detached / tunnel |
提交后在本机后台把一个 run 推到完成；把本机可达的被测应用暴露给云端浏览器 |
gherkai_runtime.textui |
人读输出的表格、树与状态颜色：表格按终端宽度排版，输出到非终端或设置了 NO_COLOR 时不带颜色 |
引擎名是 novaact 与 midscene。运行时会启动 worker 子进程、读取环境变量、访问 AWS 服务，请在配好 AWS 凭证与 region 的环境里使用。云端资源需先由部署方执行 gherkai deploy 建好；调用方的版本不能新于已部署的后端（新于即拒绝执行），旧于时只提示、不拦——建议两侧保持同版本。
文档
- 四种组合（执行方式 × 执行后端）、结果与退出码：https://github.com/zhiyanliu/gherkai/blob/HEAD/docs/user-guide/running-and-results.md
- 环境变量与选项总表：https://github.com/zhiyanliu/gherkai/blob/HEAD/docs/user-guide/configuration.md
- 云端后端怎么部署：https://github.com/zhiyanliu/gherkai/blob/HEAD/docs/user-guide/cloud-backend.md
- 每版变更：https://github.com/zhiyanliu/gherkai/blob/HEAD/CHANGELOG.md
1 maintainer
Metadata
1 maintainer
Release files for gherkai-runtime 1.4.9
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| gherkai_runtime-1.4.9.tar.gz | 64.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| gherkai_runtime-1.4.9-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 131.4 kB
Release files / gherkai_runtime-1.4.9.tar.gz
| Download URL | gherkai_runtime-1.4.9.tar.gz |
|---|---|
| Size | 64.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
62be5bd92d3158119214ae1a8990191656d29d5b9ab879658070eb2460f40d1c
|
|
BLAKE2b-256 checksum How to use checksums |
36a49979d6ce47a366c99efbbd9dff67efabb32dbaff526da42d88efb0912307
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 12, 2026.
Transparency logRelease files / gherkai_runtime-1.4.9-py3-none-any.whl
| Download URL | gherkai_runtime-1.4.9-py3-none-any.whl |
|---|---|
| Size | 66.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2af49b44d45320fbddb749d5cbec3606f2b8f208b5ca175d1be24300e32b56bd
|
|
BLAKE2b-256 checksum How to use checksums |
79c8dbfbdb41563d576261042a0d3d8e10507a80234a4e0124d4948b19812615
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 12, 2026.
Transparency log
