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: place quickstart videos under each step

rpone4b5a35fb7324
diff --git a/docs/quickstart.md b/docs/quickstart.md
index e0e1c8e0..5d15f079 100644
--- a/docs/quickstart.md
+++ b/docs/quickstart.md
@@ -22,10 +22,10 @@ npx skills add hypit-ai/hypit -g
Then start a Coding Agent anywhere; the Hypit skill is available globally.
-<video controls playsInline preload="metadata" width="100%" src="./quickstart/videos/describe_the_video_you_want.mp4"></video>
-
## 2. Describe the video you want
+<video controls playsInline preload="metadata" width="100%" src="./quickstart/videos/describe_the_video_you_want.mp4"></video>
+
You can take either of two paths.
### Clone a reference video
@@ -64,10 +64,10 @@ You can add constraints such as audience, duration, language, tone, brand colors
or aspect ratio. The Agent turns the brief into a complete plan and fills in production details from
the information you provide.
-<video controls playsInline preload="metadata" width="100%" src="./quickstart/videos/provide_credentials_when_the_agent_asks.mp4"></video>
-
## 3. Provide credentials when the Agent asks
+<video controls playsInline preload="metadata" width="100%" src="./quickstart/videos/provide_credentials_when_the_agent_asks.mp4"></video>
+
After you describe the video, the Agent checks which models and services the project needs. If a
required credential is missing, it will ask you for it and explain what it is used for. You have two
options:
@@ -82,10 +82,10 @@ options:
Never paste a secret into a public document or commit it to Git. The Agent stores credentials using
the configured secure credential store.
-<video controls playsInline preload="metadata" width="100%" src="./quickstart/videos/let_the_agent_do_the_production_work.mp4"></video>
-
## 4. Let the Agent do the production work
+<video controls playsInline preload="metadata" width="100%" src="./quickstart/videos/let_the_agent_do_the_production_work.mp4"></video>
+
Once you submit the brief, the Agent works through the project automatically without requiring you to
write source code. It does not ask questions during production; wait for the Studio mock. The exact
sequence depends on the video, but it generally includes:
@@ -112,10 +112,10 @@ sequence depends on the video, but it generally includes:
your brief, such as replacing the person on screen or adapting the video to your product, then
checks the updated result.
-<video controls playsInline preload="metadata" width="100%" src="./quickstart/videos/review_the_mock_studio.mp4"></video>
-
## 5. Review the mock Studio
+<video controls playsInline preload="metadata" width="100%" src="./quickstart/videos/review_the_mock_studio.mp4"></video>
+
When the first pass is ready, the Agent opens a Studio mock for you. A mock is a review version: it
uses deterministic stand-ins for media that has not been generated yet, while preserving the real
timing, layout, captions, transitions and track relationships. It is intended to answer “does this
@@ -132,10 +132,10 @@ while she is speaking. Please fix those issues and show me the mock again.
The Agent edits the source, reruns the relevant checks and returns an updated mock.
-<video controls playsInline preload="metadata" width="100%" src="./quickstart/videos/approve_and_submit_the_paid_build.mp4"></video>
-
## 6. Approve and submit the paid Build
+<video controls playsInline preload="metadata" width="100%" src="./quickstart/videos/approve_and_submit_the_paid_build.mp4"></video>
+
Only after you explicitly approve the mock should you ask for the paid Build:
```text
@@ -147,20 +147,20 @@ It then submits the Build, follows its progress and reports any provider or runt
language. A paid Build is the step that performs the real generation, media processing and final
rendering; the earlier mock does not silently trigger those billable operations.
-<video controls playsInline preload="metadata" width="100%" src="./quickstart/videos/review_the_paid_result.mp4"></video>
-
## 7. Review the paid result
+<video controls playsInline preload="metadata" width="100%" src="./quickstart/videos/review_the_paid_result.mp4"></video>
+
When the Build finishes, the Agent opens the resulting video and provides the saved output. Watch
the final result, not only the Studio mock. Real generated shots can differ from their mock
stand-ins, so check the generated host, B-roll, audio, captions, transitions, framing and export
quality. If the result needs a correction, tell the Agent what to change. It will revise the source
and guide you through another review rather than asking you to edit the rendered MP4 by hand.
-<video controls playsInline preload="metadata" width="100%" src="./quickstart/videos/request_natural_language_changes.mp4"></video>
-
## 8. Request natural-language changes
+<video controls playsInline preload="metadata" width="100%" src="./quickstart/videos/request_natural_language_changes.mp4"></video>
+
After a successful Build, you can continue directing the project conversationally. You may change
the host, replace B-roll, alter the ranking-board treatment, translate the script, adjust the tone or
switch the aspect ratio. For example:
@@ -173,10 +173,10 @@ look like a paper sports magazine.
The Agent traces each request to the relevant source and component, preserves what you asked it to
keep, and shows a new mock before another paid Build.
-<video controls playsInline preload="metadata" width="100%" src="./quickstart/videos/create_multiple_variants_in_parallel.mp4"></video>
-
## 9. Create multiple variants in parallel
+<video controls playsInline preload="metadata" width="100%" src="./quickstart/videos/create_multiple_variants_in_parallel.mp4"></video>
+
When you want several versions, first tell the Agent the dimensions that may vary. It will discuss
the intended directions with you, for example:
diff --git a/docs/zh/quickstart.md b/docs/zh/quickstart.md
index 5ea1fd74..40a6782f 100644
--- a/docs/zh/quickstart.md
+++ b/docs/zh/quickstart.md
@@ -20,10 +20,10 @@ npx skills add hypit-ai/hypit -g
然后在任意处启动 Coding Agent,Hypit skill 将全局可用。
-<video controls playsInline preload="metadata" width="100%" src="../quickstart/videos/describe_the_video_you_want.mp4"></video>
-
## 2. 描述你想制作的视频
+<video controls playsInline preload="metadata" width="100%" src="../quickstart/videos/describe_the_video_you_want.mp4"></video>
+
你可以选择以下两种方式之一。
### 复刻一条参考视频
@@ -53,10 +53,10 @@ npx skills add hypit-ai/hypit -g
你还可以补充目标受众、时长、语言、语气、品牌色、主持人、发布平台或画幅比例等要求。Agent 会把 brief 转换成完整计划,并自行补全制作所需的细节。
-<video controls playsInline preload="metadata" width="100%" src="../quickstart/videos/provide_credentials_when_the_agent_asks.mp4"></video>
-
## 3. 按 Agent 提示提供凭据
+<video controls playsInline preload="metadata" width="100%" src="../quickstart/videos/provide_credentials_when_the_agent_asks.mp4"></video>
+
在你描述视频之后,Agent 会检查项目需要哪些模型和服务。如果缺少必要凭据,Agent 会向你询问,并说明该凭据的用途。你可以选择两种方式:
1. **使用 Hypit 推荐的 hypit.ai OAuth 登录。** 告诉 Agent 通过 hypit.ai 登录。一次 OAuth 登录即可覆盖 Hypit 托管服务提供的所有模型,不需要为每个模型分别收集 key。
@@ -64,10 +64,10 @@ npx skills add hypit-ai/hypit -g
不要把密钥粘贴到公开文档中,也不要提交到 Git。Agent 会使用已配置的安全凭据存储来保存这些凭据。
-<video controls playsInline preload="metadata" width="100%" src="../quickstart/videos/let_the_agent_do_the_production_work.mp4"></video>
-
## 4. 让 Agent 完成制作
+<video controls playsInline preload="metadata" width="100%" src="../quickstart/videos/let_the_agent_do_the_production_work.mp4"></video>
+
收到 brief 后,Agent 会在不要求你编写源码的情况下自动推进项目。制作过程中不会询问任何问题,你只需等待 Studio mock。具体顺序会因视频而不同,但通常包括:
1. **拆分镜头。** Agent 识别口播段落、视觉节拍、转场、字幕、B-roll 机会,以及 ranking 板等需要持续保持的元素。
@@ -79,10 +79,10 @@ npx skills add hypit-ai/hypit -g
7. **与 mock 对比。** 对尚未真正生成的素材使用 mock,随后在 Studio 中渲染完整构图;Agent 会把看到的结果与参考视频或 brief 对比,修复时机、层级、裁切、字幕和画面密度等问题。
8. **按照要求完成修改。** 基础视频确定后,Agent 会根据你的要求完成定制,例如更换画面中的人物,或替换成你的产品,然后检查修改后的结果。
-<video controls playsInline preload="metadata" width="100%" src="../quickstart/videos/review_the_mock_studio.mp4"></video>
-
## 5. 查看 mock Studio
+<video controls playsInline preload="metadata" width="100%" src="../quickstart/videos/review_the_mock_studio.mp4"></video>
+
第一版完成后,Agent 会为你打开 Studio mock。Mock 是审阅版本:尚未生成的媒体会使用确定性的临时素材代替,但真实的时序、布局、字幕、转场和 Track 关系都会保留。它要回答的是“这支视频是否成立”,而不是在你确认之前悄悄执行付费生成或最终渲染。
请从头到尾观看 mock,检查故事是否清楚、镜头顺序是否正确、字幕在手机上是否易读、ranking 板或产品是否突出、B-roll 节奏是否合适,以及整体语气是否符合 brief。如果发现问题,直接用日常语言告诉 Agent:
@@ -93,10 +93,10 @@ ranking 板出现得太晚,字幕太小,而且主持人说话时被 B-roll
Agent 会修改源码、重新检查并返回更新后的 mock。
-<video controls playsInline preload="metadata" width="100%" src="../quickstart/videos/approve_and_submit_the_paid_build.mp4"></video>
-
## 6. 确认后提交付费 Build
+<video controls playsInline preload="metadata" width="100%" src="../quickstart/videos/approve_and_submit_the_paid_build.mp4"></video>
+
只有在你明确确认 mock 后,才要求 Agent 提交付费 Build:
```text
@@ -105,16 +105,16 @@ mock 没有问题。请提交付费 Build 并生成最终视频。
开始之前,Agent 会向你总结将使用的模型、预计执行的外部工作和预估费用。随后它会提交 Build、跟踪进度,并用书面化的语言报告 Provider 或 Runtime 问题。付费 Build 才会执行真实的素材生成、媒体处理和最终渲染;之前的 mock 不会自动触发这些计费操作。
-<video controls playsInline preload="metadata" width="100%" src="../quickstart/videos/review_the_paid_result.mp4"></video>
-
## 7. 查看付费 Build 的结果
-Build 完成后,Agent 会打开最终视频并提供保存后的输出文件。请查看最终结果,而不只是 Studio mock。真实生成的主持人、B-roll 和音频可能与 mock 的临时素材不同,因此要检查画面、字幕、转场、构图、声音和导出质量。如果需要修改,直接告诉 Agent 要改什么。Agent 会修改源码并带你重新审阅,而不是让你手动编辑已经渲染出的 MP4。
+<video controls playsInline preload="metadata" width="100%" src="../quickstart/videos/review_the_paid_result.mp4"></video>
-<video controls playsInline preload="metadata" width="100%" src="../quickstart/videos/request_natural_language_changes.mp4"></video>
+Build 完成后,Agent 会打开最终视频并提供保存后的输出文件。请查看最终结果,而不只是 Studio mock。真实生成的主持人、B-roll 和音频可能与 mock 的临时素材不同,因此要检查画面、字幕、转场、构图、声音和导出质量。如果需要修改,直接告诉 Agent 要改什么。Agent 会修改源码并带你重新审阅,而不是让你手动编辑已经渲染出的 MP4。
## 8. 继续用自然语言提出修改
+<video controls playsInline preload="metadata" width="100%" src="../quickstart/videos/request_natural_language_changes.mp4"></video>
+
Build 成功后,你仍然可以用对话继续指导项目。你可以更换主持人、替换 B-roll、改变 ranking 板的样式、翻译台词、调整语气或切换画幅比例。例如:
```text
@@ -123,10 +123,10 @@ Build 成功后,你仍然可以用对话继续指导项目。你可以更换
Agent 会把每项要求追踪到对应的源码和组件,保留你要求不变的部分,并在再次付费 Build 前先给你看新的 mock。
-<video controls playsInline preload="metadata" width="100%" src="../quickstart/videos/create_multiple_variants_in_parallel.mp4"></video>
-
## 9. 并行制作多个变体
+<video controls playsInline preload="metadata" width="100%" src="../quickstart/videos/create_multiple_variants_in_parallel.mp4"></video>
+
如果需要多个版本,先告诉 Agent 哪些维度可以变化。它会与你讨论具体方向,例如:
- 更换主持人的版本;