Skip to content

armgit / hypit

Public Imported from GitHub
0

Clone any viral video with AI agents. Not just a script, the whole workflow: swap the face, the words, the B-roll, ship 100 variants in one command, and get your 100M views.

docs: show optional package installation commands

rpone85e01c767164
diff --git a/docs/guide/providers.md b/docs/guide/providers.md
index ce7679ba..4aff6fbf 100644
--- a/docs/guide/providers.md
+++ b/docs/guide/providers.md
@@ -10,7 +10,8 @@ The Runtime Profile binds the requested capability to an Endpoint.
Hypit's official Distribution selects local Providers and the HypiHub Provider as defaults.
TokenDance, HiAPI, Pollo, BeatAPI and Monid Providers are independently versioned optional npm packages, not default dependencies.
-Install the chosen Provider in the video project. Other services connect through packages owned by the
+Install the chosen Provider in the video project, e.g. `npm install @hypit/provider-hiapi`.
+Other services connect through packages owned by the
production or their authors. The Agent can implement a new service through the public SDK, just as
it can create a visual component for a video.
[Model and deployment services](./service-partners.md) introduces independent partners through that
diff --git a/docs/guide/service-partners.md b/docs/guide/service-partners.md
index 7e8edc12..24339a83 100644
--- a/docs/guide/service-partners.md
+++ b/docs/guide/service-partners.md
@@ -18,8 +18,14 @@ does not activate the service. Each Provider maps the installed models that serv
that service's input limits, and its README lists both. A model the service offers beyond that set connects through the ordinary
[Model and Provider](./providers.md) extension path.
+In the video project, run only the command for the selected service:
+
```bash
npm install @hypit/provider-tokendance
+npm install @hypit/provider-hiapi
+npm install @hypit/provider-pollo
+npm install @hypit/provider-beatapi
+npm install @hypit/provider-monid
```
## Model and tool API partners
diff --git a/docs/zh/guide/providers.md b/docs/zh/guide/providers.md
index 6c2e1539..186238d2 100644
--- a/docs/zh/guide/providers.md
+++ b/docs/zh/guide/providers.md
@@ -5,7 +5,7 @@ description: 选择账户、连接服务或添加模型,沿用同一套视频
**Model** 定义要生成什么:输入、支持的参数和输出类型。**Provider** 知道如何通过某个服务完成这个请求。**Endpoint** 是配置好的 Provider 实例,包含服务地址、凭据引用和容量。Runtime Profile 将所需能力绑定到 Endpoint。
-官方 Distribution 默认选择本地 Provider 与 HypiHub Provider。TokenDance、HiAPI、Pollo、BeatAPI 和 Monid Provider 是独立版本的可选包,不是默认依赖,需在视频项目中额外安装所选包。其他服务通过项目或作者自己的包接入;Agent 可以使用公开 SDK 编写所需接入,就像为视频创建视觉组件。[模型与部署服务](./service-partners.md) 集中介绍独立合作服务,它们沿用同一套扩展方式。选择执行服务,与[选择 Agent 工作环境](./agents.md)是两件事。
+官方 Distribution 默认选择本地 Provider 与 HypiHub Provider。TokenDance、HiAPI、Pollo、BeatAPI 和 Monid Provider 是独立版本的可选包,不是默认依赖,需在视频项目中额外安装所选包,例如 `npm install @hypit/provider-hiapi`。其他服务通过项目或作者自己的包接入;Agent 可以使用公开 SDK 编写所需接入,就像为视频创建视觉组件。[模型与部署服务](./service-partners.md) 集中介绍独立合作服务,它们沿用同一套扩展方式。选择执行服务,与[选择 Agent 工作环境](./agents.md)是两件事。
HypiHub 是我们推荐的集成托管服务。**BYOK** 指使用自己账户的 API Key:Key 通过兼容的 Provider 连接到签发它的服务。告诉 Agent 你已有哪个服务及其 API 文档,具体接线和项目包可以由 Agent 完成。Key 负责授权请求,本身不会实现 API 接口。一个项目可以为不同能力使用不同服务,分别使用各自的账户并按各自规则计费。
diff --git a/docs/zh/guide/service-partners.md b/docs/zh/guide/service-partners.md
index c6f11267..216cebfb 100644
--- a/docs/zh/guide/service-partners.md
+++ b/docs/zh/guide/service-partners.md
@@ -15,8 +15,14 @@ Runtime Profile 中引用它;安装本身不会启用服务。Provider 覆盖
并按该服务的输入限制报告不支持的请求;具体清单见各 Provider 的 README。
服务提供、但不在这个范围内的模型,通过普通的 [Model 与 Provider](./providers.md) 扩展方式连接。
+在视频项目目录中,只执行所选服务对应的一条命令:
+
```bash
npm install @hypit/provider-tokendance
+npm install @hypit/provider-hiapi
+npm install @hypit/provider-pollo
+npm install @hypit/provider-beatapi
+npm install @hypit/provider-monid
```
## 模型与工具 API 合作方
diff --git a/migrations/0.3.1.md b/migrations/0.3.1.md
index 31246111..aa09fa26 100644
--- a/migrations/0.3.1.md
+++ b/migrations/0.3.1.md
@@ -33,7 +33,7 @@ a global executable does not update the project's explicit component dependencie
| `@hypit/run-markup` cannot be found | Use the [current Run header](0.3.md#cannot-locate-installed-package-hypitrun-markup); no extra reader package is needed |
| A former root domain subpath is not exported | Migrate that component's import using the table below |
| A new domain package cannot be found | Declare and install it in the package that imports it |
-| Ranking or a partner Provider cannot be found | These are optional, not default dependencies; install the selected package in the project, e.g. `npm install @hypit/ranking@^0.1.0` |
+| Ranking or a partner Provider cannot be found | These are optional, not default dependencies; install the selected package in the project, e.g. `npm install @hypit/ranking@^0.1.0` or `npm install @hypit/provider-hiapi` |
| The error originates inside an installed third-party package | Select an available migrated release, or explicitly arrange a source-level repair with the user |
| Installation reports conflicting peer versions | Inspect the root and the named package's requirements together; choose a compatible set |
| Files are updated but a running Studio or Worker still uses old code | Check the active process and installation, then restart that process when active work permits |
diff --git a/migrations/0.3.1.zh-CN.md b/migrations/0.3.1.zh-CN.md
index 0522bc28..abe943e2 100644
--- a/migrations/0.3.1.zh-CN.md
+++ b/migrations/0.3.1.zh-CN.md
@@ -31,7 +31,7 @@ rg -n '@hypit/hypit/' packages --glob '*.{ts,tsx,js,mjs,cjs,json}' --glob '!node
| 找不到 `@hypit/run-markup` | 使用[当前 Run 文件头](0.3.zh-CN.md#cannot-locate-installed-package-hypitrun-markup);不需要额外的解析器包 |
| 主包原来的领域子路径不再导出 | 按下表迁移该组件的导入 |
| 找不到新的领域包 | 在实际导入它的包中声明并安装依赖 |
-| 找不到 Ranking 或合作 Provider | 它们是可选包,不是默认依赖;在项目中安装所选包,例如 `npm install @hypit/ranking@^0.1.0` |
+| 找不到 Ranking 或合作 Provider | 它们是可选包,不是默认依赖;在项目中安装所选包,例如 `npm install @hypit/ranking@^0.1.0` 或 `npm install @hypit/provider-hiapi` |
| 错误来自已安装的第三方包内部 | 选择已发布的迁移版本,或与用户明确约定源码修复 |
| 安装时报告 peer 版本冲突 | 同时检查主包与报错包的要求,选择兼容的版本组合 |
| 文件已更新,但运行中的 Studio 或 Worker 仍使用旧代码 | 检查当前进程和安装;在不影响正在进行的工作时重启该进程 |
diff --git a/migrations/0.3.md b/migrations/0.3.md
index 8a428a35..5c0c69f4 100644
--- a/migrations/0.3.md
+++ b/migrations/0.3.md
@@ -79,7 +79,8 @@ API credentials do not affect reader resolution. `hypit cli use` selects install
contributions, not document readers; `hypit packages install` is not a current command.
For a genuinely missing external capability package, use the project's ordinary package manager.
Ranking and other optional components, plus partner Providers, are not included in the default
-installation. Install the selected package in the project, for example `npm install @hypit/ranking@^0.1.0`;
+installation. Install the selected package in the project, for example `npm install @hypit/ranking@^0.1.0`
+or `npm install @hypit/provider-hiapi`;
for repository examples with a lockfile, use `npm ci` as their README directs.
## 3. Migrate the work's relationships, not just tag names
diff --git a/migrations/0.3.zh-CN.md b/migrations/0.3.zh-CN.md
index c233aeda..cb407ff5 100644
--- a/migrations/0.3.zh-CN.md
+++ b/migrations/0.3.zh-CN.md
@@ -77,7 +77,8 @@ API 凭据不影响解析器的查找。`hypit cli use` 选择已安装的命令
`hypit packages install` 不是当前支持的命令。
如果确实缺少外部能力包,请使用项目的普通包管理器安装。
Ranking 等可选组件和合作 Provider 不随默认安装提供。请在项目中安装所选包,
-例如 `npm install @hypit/ranking@^0.1.0`;仓库中带 lockfile 的示例按其 README 执行 `npm ci`。
+例如 `npm install @hypit/ranking@^0.1.0` 或 `npm install @hypit/provider-hiapi`;
+仓库中带 lockfile 的示例按其 README 执行 `npm ci`。
## 3. 迁移作品中的关系,而不只是标签名称
diff --git a/skills/hypit/references/environment/model-and-provider.md b/skills/hypit/references/environment/model-and-provider.md
index c73f7cab..b6ceff28 100644
--- a/skills/hypit/references/environment/model-and-provider.md
+++ b/skills/hypit/references/environment/model-and-provider.md
@@ -49,6 +49,16 @@ introduces partners and links their own documentation. A partnership alone does
particular capability, account or implementation is available. Carry an already suitable, chosen
service forward.
+In the video project, run only the command for the selected service:
+
+```bash
+npm install @hypit/provider-tokendance
+npm install @hypit/provider-hiapi
+npm install @hypit/provider-pollo
+npm install @hypit/provider-beatapi
+npm install @hypit/provider-monid
+```
+
BYOK means using an account/key supplied by the user. A HypiHub API key connects HypiHub; a different
service's key connects that service. OAuth and static keys are credential methods, not different
model capabilities. A Profile can mix services by capability.
diff --git a/skills/hypit/references/production/component-design.md b/skills/hypit/references/production/component-design.md
index ee36f244..994de384 100644
--- a/skills/hypit/references/production/component-design.md
+++ b/skills/hypit/references/production/component-design.md
@@ -117,8 +117,8 @@ coordinated explainer scenes. Trace why a behavior has its owner, what drives it
inputs a changed brief would replace. Their notes explain those choices; the scene lists are each
production's design. In the explainer, scenes retain fixed internal details while Script events,
Caption and presenter framing remain independently authored.
-Install the selected example's declared dependencies first; `npm ci` installs optional components
-such as Ranking where its README and lockfile specify them.
+Install the selected example's declared dependencies with `npm ci` as its README directs;
+in another project selecting Ranking, use `npm install @hypit/ranking@^0.1.0`.
For that whole-work relationship, read [Presenter-led visual explainers](../playbooks/formats/presenter-led-explainer.md).
The [explainer's craft notes](https://github.com/hypit-ai/hypit/blob/main/examples/complex-explainer/productions/explainer/CRAFT-NOTES.md)
trace concrete revisions back to their design decisions and source owners.