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: open the Quickstart with where the name comes from

rpone62d82dc97135
diff --git a/docs/quickstart.md b/docs/quickstart.md
index 557ecd9d..6915ae62 100644
--- a/docs/quickstart.md
+++ b/docs/quickstart.md
@@ -5,11 +5,33 @@ description: Install Narratage, compile a complete SVML video graph, and prepare
# Quickstart
-Narratage turns an SVML (Semantic Video Markup Language) author source — a `.svml` file — into a
-visible execution graph. Before any model or external service runs, you can check the source, choose
-a Run, and inspect the exact work it would require.
+The name **Narratage** comes from a 1933 *New York Times* review of the film *The Power and the
+Glory*. The critic coined the word to describe a then-new cinematic technique:
+**Narration + Montage** — a narrator's voice carries the story forward while the screen assembles
+a montage of scenes to match.
-This page gets you to that first safe plan. It does not need API keys and does not make a paid call.
+That is exactly what this system does. The author writes a narrated Script with semantic anchors,
+and the compiler assembles generated video, captions, B-roll, text and audio into a finished film.
+Words are the semantic spine; visual contributions remain independently authored Tracks. Author
+Sources are written in SVML (Semantic Video Markup Language) and carry the `.svml` extension.
+
+Narratage turns that source into a visible execution graph. Before any model or external service
+runs, you can check the source, choose a Run, and inspect the exact work it would require. This
+page gets you to that first safe plan: it needs no API keys and makes no paid call.
+
+## Use the Narratage skill
+
+If you use a coding agent, ask it to use the repository's `narratage` skill. The skill follows the
+same files and commands; it does not introduce a separate workflow. Send it this:
+
+```text
+Install and use the narratage skill from this repository. Install the whole
+.agents/skills/narratage folder, not only SKILL.md. Set up my environment, ask for only the API
+keys required by my Runtime Profile, and guide me through authoring and building my first SVML
+video.
+```
+
+Otherwise, work through the five steps below.
## 1. Install the source workspace
@@ -183,22 +205,3 @@ Follow the authoring path in order, or jump directly to the part you are changin
| [Film & Rendering](./quickstart/composition.md) | Peer Track composition and explicit rendering |
| [Run Source & Builds](./quickstart/run.md) | Targets, reuse, Runtime Profiles, Builds and retrieval |
-## Use the Narratage skill
-
-If you use a coding agent, ask it to use the repository's `narratage` skill. The skill follows the
-same files and commands; it does not introduce a separate workflow.
-
-Send it this:
-
-```text
-Install and use the narratage skill from this repository. Install the whole
-.agents/skills/narratage folder, not only SKILL.md. Set up my environment, ask for only the API
-keys required by my Runtime Profile, and guide me through authoring and building my first SVML
-video.
-```
-
-## Why the name
-
-*Narratage* was coined for narration-driven montage: the narration carries the story while images
-assemble around it. That is the original video form behind this project—words are the semantic
-spine, and visual contributions remain independently authored Tracks.
diff --git a/docs/zh/quickstart.md b/docs/zh/quickstart.md
index e0723a8a..c0a09b1f 100644
--- a/docs/zh/quickstart.md
+++ b/docs/zh/quickstart.md
@@ -5,11 +5,30 @@ description: 安装 Narratage,编译第一张完整的 SVML 视频图,并准
# 快速开始
-Narratage 把 SVML 作者源码编译成一张可见的执行图。在任何模型或外部服务开始工作之前,
-你可以先检查源码、选择一次 Run,并看清这次 Build 究竟需要执行什么。
-SVML 即 Semantic Video Markup Language,Author Source 的扩展名是 `.svml`。
+**Narratage** 这个名字来自 1933 年《*New York Times*》对电影《*The Power and the
+Glory*》的一篇影评。那位影评人造出这个词,用来描述当时的一种新兴电影手法:
+**Narration + Montage** —— 旁白的声音推动故事前进,同时画面组接出与之呼应的蒙太奇。
-本页先带你得到第一份安全的 Plan:不需要 API Key,也不会产生任何付费请求。
+这套系统做的正是这件事。作者写下带有语义锚点的口播 Script,编译器则把生成的视频、字幕、B-roll、
+文字与音频组装成一部完成的影片。文字是语义主轴,所有视觉内容以彼此平级的 Track 参与作品。
+Author Source 使用 SVML(Semantic Video Markup Language)编写,扩展名为 `.svml`。
+
+Narratage 把这份源码编译成一张可见的执行图。在任何模型或外部服务开始工作之前,你可以先检查源码、
+选择一次 Run,并看清这次 Build 究竟需要执行什么。本页先带你得到第一份安全的 Plan:不需要 API Key,
+也不会产生任何付费请求。
+
+## 使用 Narratage skill
+
+如果使用编程 Agent,可以要求它使用仓库中的 `narratage` skill。Skill 遵循的仍然是同一套文件和命令,
+不会创造另一套工作流。把下面这段发给它:
+
+```text
+安装并使用这个仓库里的 narratage skill。要安装整个 .agents/skills/narratage 文件夹,
+而不是只复制 SKILL.md。配置我的环境,只向我索取当前 Runtime Profile 实际需要的 API key,
+然后带我完成第一支 SVML 视频的创作与 Build。
+```
+
+否则,按下面五个步骤依次进行。
## 1. 安装源码工作区
@@ -179,20 +198,3 @@ Endpoint 配置,但不会执行作者图。
| [Film 与渲染](./quickstart/composition.md) | 平级 Track 合成与显式渲染 |
| [Run Source 与 Builds](./quickstart/run.md) | Targets、复用、Runtime Profile、Build 与取回结果 |
-## 使用 Narratage skill
-
-如果使用编程 Agent,可以要求它使用仓库中的 `narratage` skill。Skill 遵循的仍然是同一套文件和命令,
-不会创造另一套工作流。
-
-把下面这段发给它:
-
-```text
-安装并使用这个仓库里的 narratage skill。要安装整个 .agents/skills/narratage 文件夹,
-而不是只复制 SKILL.md。配置我的环境,只向我索取当前 Runtime Profile 实际需要的 API key,
-然后带我完成第一支 SVML 视频的创作与 Build。
-```
-
-## 名字的由来
-
-*Narratage* 原本描述的是“叙述驱动的蒙太奇”:声音负责推动故事,画面围绕叙述组接。
-这也是本项目最初的视频形态——文字是语义主轴,所有视觉内容以彼此平级的 Track 参与作品。