Simplify setup to one sourced Bash configuration

README.md

@@ -11,58 +11,55 @@ tags:
 - aidem
 ---
 
-# Audio8-ASR-Infinite-160ms · Agora 模型资源
+# Audio8-ASR-Infinite-160ms for Agora
 
-这是面向 Agora 的 **160ms** 资源副本。这里仅放模型包、资源声明、校验表和许可，应用源码、Python venv、示例与运行文档位于 [GitHub Agora 副本](https://github.com/APLUX-Agora/audio8-asr-infinite-demo)。原始模型来自 [Edge0/Audio8-ASR-Infinite](https://huggingface.co/Edge0/Audio8-ASR-Infinite)。
+This public repository contains the **160ms** model package for Agora. Application code, the SDK, dependencies, and examples live in [APLUX-Agora/audio8-asr-infinite-demo](https://github.com/APLUX-Agora/audio8-asr-infinite-demo). The upstream model is [Edge0/Audio8-ASR-Infinite](https://huggingface.co/Edge0/Audio8-ASR-Infinite).
 
-## 安装与启动
+## Deployment
 
-统一按照 [Agora 开发者部署指南](https://github.com/APLUX-Agora/audio8-asr-infinite-demo/blob/main/docs/AGORA_DEPLOY.md) 执行。没有 Agora CLI：第一步创建一份可编辑的 **agora.env**，把 workspace、仓库、SoC、系统、目录和运行参数声明好，**source 一次后正常执行后续命令**。不再使用 JSON 转参数文件或安装包装脚本。
+Follow the [shared deployment guide](https://github.com/APLUX-Agora/audio8-asr-infinite-demo/blob/main/docs/AGORA_DEPLOY.md). **Declare parameters once in agora.env, source it, then run normal commands.** Agora fills the configuration from your content and hardware selections; developers using GitHub can edit the same template themselves. No Agora CLI, credentials, or second generated parameter file is required.
 
-网页选择 160ms 时，模型仓库为 `APLUX-Agora/Audio8-ASR-Infinite-160ms`、A8_CLOCK_MS 为 160，模型目录为 `$AGORA_WORKSPACE/models/audio8-160ms`。配置中的 AGORA_MODEL_FILES 数组声明公共文件及所选 SoC，后面直接使用 HF 官方命令下载：
+For this variant, set AGORA_MODEL_REPO to `APLUX-Agora/Audio8-ASR-Infinite-160ms`, A8_CLOCK_MS to `160`, and AGORA_MODELS_DIR to `$AGORA_WORKSPACE/models/audio8-160ms`. The configuration's AGORA_MODEL_FILES array selects common files and one SoC target. After creating the project venv and installing huggingface_hub, download with the standard command:
 
 ```bash
-.venv/bin/hf download "$AGORA_MODEL_REPO" \
-  --local-dir "$AGORA_MODELS_DIR" --include "${AGORA_MODEL_FILES[@]}"
+.venv/bin/hf download "$AGORA_MODEL_REPO" --local-dir "$AGORA_MODELS_DIR" --include "${AGORA_MODEL_FILES[@]}"
 ```
 
-仓库公开，匿名下载即可，不需要 HF token。首次使用前按 GitHub 指南创建项目 venv 并安装 huggingface_hub。打开新终端先 source 一次配置，已有代码或模型是否更新由开发者自行决定。
+Downloads are public and anonymous. Open a new terminal? Source your configuration again before continuing. Updating an existing checkout or model package remains your decision.
 
-## 下载原则
-
-- 一次 hf download 获取公共资源及 `targets/$AGORA_MODEL_TARGET/*`，不下载其它 SoC 图；命令见上述指南第四步。
-- 资源直接保存到 `$AGORA_MODELS_DIR`，与代码分开，--models 指向含 models.json 的根目录。
-- 每种时钟独立目录。单个目标约 **3.3 GiB / 3.55 GB**，workspace 建议至少 8 GiB 可用空间。
-- 下载默认 main，不要求用户复制长 revision；需要固定版本时可用 HF 原生 --revision 并记录快照。
-- SHA256SUMS 校验已下载文件。--ignore-missing 允许其它未选 SoC 缺席，不代表资源齐全；启动时还会按 models.json 检查必需文件。
+## Resource layout
 
 ```text
 $AGORA_MODELS_DIR/
-├── models.json                 # SDK 模型包入口
-├── agora-model.json            # 资源来源、目标及兼容声明
+├── models.json                 # SDK package entry point
+├── agora-model.json            # Resource and compatibility metadata
 ├── SHA256SUMS / README.md
 ├── embedding.bin / *.npy / tokenizer.json / token_bytes.json
 ├── frontend/ prefix/ semantic_vad/
-├── targets/<所选SoC>_qnn248/
+├── targets/<selected-soc>_qnn248/
 └── LICENSES/ NOTICE
 ```
 
-## 硬件资源与兼容范围
+Download common files and only the selected target in one HF snapshot. No extraction or manual file moves are needed. --models takes the root containing models.json, not the targets directory. A single target is approximately **3.3 GiB / 3.55 GB**; allow at least 8 GiB for code, dependencies, and resources. Keep 80ms and 160ms in separate directories.
+
+The default guide uses main. Use HF's native --revision option when you need an immutable snapshot. SHA256SUMS checks downloaded bytes; --ignore-missing permits intentionally absent other-SoC files but does not prove package completeness. Web startup also checks required resources and hashes.
+
+## Targets and qualification
 
-| SoC | Ubuntu 选择映射 | 模型目录 | 验收状态 |
+| SoC | Ubuntu selection | Target directory | Qualification |
 | --- | --- | --- | --- |
-| QCS8550 | 22.04 | targets/qcs8550_qnn248 | 已验证 |
-| QCS8625 | 22.04 | targets/qcs8625_qnn248 | 整体运行待验证 |
-| IQ8 / QCS8275 | 24.04 | targets/qcs8275_qnn248 | 整体运行待验证 |
-| IQ9 / QCS9075 | 24.04 | targets/qcs9075_qnn248 | 整体运行待验证 |
+| QCS8550 | 22.04 | targets/qcs8550_qnn248 | Validated |
+| QCS8625 | 22.04 | targets/qcs8625_qnn248 | End-to-end validation pending |
+| IQ8 / QCS8275 | 24.04 | targets/qcs8275_qnn248 | End-to-end validation pending |
+| IQ9 / QCS9075 | 24.04 | targets/qcs9075_qnn248 | End-to-end validation pending |
 
-当前预编译 SDK 为 0.9.0，已验证 QCS8550 / Ubuntu22.04 / AidLite2.5.0.284 / QNN2.48 与 Python3.10/3.11/3.12。资源存在不代表其它 BSP、SoC 或 Ubuntu 版本已兼容；Ubuntu26.04 未验收。模型图、张量及 models.json 格式保持原样，Agora 仅新增部署说明与资源声明。
+Native SDK 0.9.0 is qualified on QCS8550 / Ubuntu22.04 / AidLite2.5.0.284 / QNN2.48 with CPython3.10/3.11/3.12. Resource availability does not qualify another BSP, SoC, or operating system. Ubuntu26.04 is unqualified. Model graphs, tensor bytes, and models.json format are unchanged by the Agora documentation work.
 
-## 第一次运行
+## First run
 
-先在 GitHub 仓库运行 20 秒短样例，观察“加载 / 识别 / 完成”提示与最终文本，再按需启动 Web Demo。云真机在完整远程桌面内打开设备浏览器 localhost:8765；本地设备使用设备本机或同一网络地址。文件测试与 Web 启动是两个独立操作，不自动串行启动。
+Start with the 20-second file example in the GitHub repository. It reports model loading, transcription, and completion before printing the result. Start the Web Demo separately when needed. On a cloud board, use the browser inside the full remote desktop at localhost:8765; on your own board, use the board's browser or its network address.
 
-[Python API](https://github.com/APLUX-Agora/audio8-asr-infinite-demo/blob/main/sdk/PYTHON_API.md) · [C/C++ 集成](https://github.com/APLUX-Agora/audio8-asr-infinite-demo/blob/main/sdk/NATIVE_INTEGRATION.md) · [模型包约定](https://github.com/APLUX-Agora/audio8-asr-infinite-demo/blob/main/sdk/MODEL_PACKAGE.md)
+[Python API](https://github.com/APLUX-Agora/audio8-asr-infinite-demo/blob/main/sdk/PYTHON_API.md) · [C/C++ integration](https://github.com/APLUX-Agora/audio8-asr-infinite-demo/blob/main/sdk/NATIVE_INTEGRATION.md) · [Package contract](https://github.com/APLUX-Agora/audio8-asr-infinite-demo/blob/main/sdk/MODEL_PACKAGE.md)
 
 ## License
 
@@ -73,4 +70,4 @@ Full license texts are in [LICENSES/](LICENSES/): [Pandora agreement (Chinese)](
 SDK CPU placement defaults to `inherit`; the official Demo chooses `default`.
 Both Python and C accept an explicit CPU set without changing model resources.
 See the [CPU interface and platform profiles](https://github.com/APLUX-Agora/audio8-asr-infinite-demo/blob/main/sdk/CPU_AFFINITY.md)
-and [Demo running and inference SDK](https://github.com/APLUX-Pandora/audio8-asr-infinite-demo) on GitHub.
+and [Demo running and inference SDK](https://github.com/APLUX-Agora/audio8-asr-infinite-demo) on GitHub.

SHA256SUMS

@@ -2,8 +2,8 @@ cfc7749b96f63bd31c3c42b5c471bf756814053e847c10f3eb003417bc523d30  LICENSES/Apach
 2de3adf5d4afde83c75ddff3bfe596f9f769acfa746a51ae7ea7e949d2ff297c  LICENSES/Pandora-Model-SDK.en.txt
 2552f7a6eb20986f706e2512fabef6224b9304de8507b8b7896c24e56e5685a1  LICENSES/Pandora-Model-SDK.zh-CN.txt
 47c5742e98d742e6d6a0e26a9b0707200ceb155434f05f150edb9b596cb68378  NOTICE
-7fd58c9c7ad377dfe6edde5c3302ebd0cae89b61a5ceff4b34230ef7ce080222  README.md
-103893a0472810e42b8a5295739dbd257f1e9335000e66ba650500dba99d9d66  agora-model.json
+3c77b9db0847c0e4240c2af150b59af9034ee6d34a49c07317162ee5b572280f  README.md
+2021750fecb58e9901ca1af05061dcbf34f8a12732d4ca71de05f26acc6b2b2a  agora-model.json
 18f549e98fe991bd403b898a524df64467d9a7a9cdad1d3849bcbd91b95e37fe  embedding.bin
 ca85fbe03e0f351470fabbf8c5444693f35e1fc7ef472964e3fe7101db055c23  frontend/config.json
 906bfb42b5f526dd4177739d29b5800de98cb448e8336d379da50bc90198278b  frontend/rows_const.npy

agora-model.json

@@ -58,6 +58,6 @@
       "approx_download_bytes": 3553730233
     }
   ],
-  "notes": "Ubuntu 系统字段是 Agora 选择映射。仅 QCS8550/Ubuntu22.04 通过当前 SDK 整链路验收；其它组合待验证。此声明不是安装脚本。",
+  "notes": "Ubuntu fields describe Agora selection mappings. Only QCS8550/Ubuntu22.04 is qualified end-to-end with the current native SDK; other combinations require validation. This declaration is not an installation script.",
   "configuration": "agora.env"
 }