Simplify setup to one sourced Bash configuration

README.md

@@ -17,20 +17,25 @@ This public repository contains the **80ms** model package for Agora. Applicatio
 
 ## Deployment
 
-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.
+Use the [shared deployment guide](https://github.com/APLUX-Agora/audio8-asr-infinite-demo/blob/main/docs/AGORA_DEPLOY.md). Developers using GitHub edit the [common configuration template](https://github.com/APLUX-Agora/audio8-asr-infinite-demo/blob/main/agora/agora.env.example); Agora fills the same format from selected content and hardware.
 
-For this variant, set AGORA_MODEL_REPO to `APLUX-Agora/Audio8-ASR-Infinite-80ms`, A8_CLOCK_MS to `80`, and AGORA_MODELS_DIR to `$AGORA_WORKSPACE/models/audio8-80ms`. 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:
+The global file declares only workspace, content ID, code/resource sources and versions, SoC, and operating system. For this package, AGORA_RESOURCE_REPO is `APLUX-Agora/Audio8-ASR-Infinite-80ms`. It does not contain Audio8 clocks, ports, model filenames, or target-directory names. The SDK and Web Demo read the clock from models.json. The project owns its resource filters in [agora/resources.env](https://github.com/APLUX-Agora/audio8-asr-infinite-demo/blob/main/agora/resources.env).
+
+After loading the common configuration, getting the code, and creating the project venv, run from workspace/code:
 
 ```bash
-.venv/bin/hf download "$AGORA_MODEL_REPO" --local-dir "$AGORA_MODELS_DIR" --include "${AGORA_MODEL_FILES[@]}"
+source agora/resources.env
+.venv/bin/python -m pip install huggingface_hub
+.venv/bin/hf download "$AGORA_RESOURCE_REPO" --revision "$AGORA_RESOURCE_REF" \
+  --local-dir "$AGORA_WORKSPACE/resources" --include "${AUDIO8_DOWNLOAD_PATTERNS[@]}"
 ```
 
-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.
+This is the official HF downloader, with project-maintained file selection. No Agora CLI or authentication is required. The global configuration does not need to track changes to model filenames. Re-source it when opening a new terminal, and choose a separate workspace when switching content/hardware/model variants.
 
 ## Resource layout
 
 ```text
-$AGORA_MODELS_DIR/
+$AGORA_WORKSPACE/resources/
 ├── models.json                 # SDK package entry point
 ├── agora-model.json            # Resource and compatibility metadata
 ├── SHA256SUMS / README.md
@@ -40,7 +45,7 @@ $AGORA_MODELS_DIR/
 └── 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.
+Download common files and only the selected target in one HF snapshot. No extraction or manual file moves are needed. --models takes workspace/resources, the root containing models.json, not its targets directory. A single target is approximately **3.3 GiB / 3.55 GB**; allow at least 8 GiB for code, dependencies, and resources. Use a separate workspace for each selected model/hardware combination.
 
 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.
 

SHA256SUMS

@@ -2,8 +2,8 @@ cfc7749b96f63bd31c3c42b5c471bf756814053e847c10f3eb003417bc523d30  LICENSES/Apach
 2de3adf5d4afde83c75ddff3bfe596f9f769acfa746a51ae7ea7e949d2ff297c  LICENSES/Pandora-Model-SDK.en.txt
 2552f7a6eb20986f706e2512fabef6224b9304de8507b8b7896c24e56e5685a1  LICENSES/Pandora-Model-SDK.zh-CN.txt
 7f8d21c8608897b9828af5caa12484ab2e0fe72c596eb2cf12252d35b3b599b0  NOTICE
-98f281d095822f86c4a50f1a7ead5498cf47192d01bfab3d552cb9ba266fccc7  README.md
-c47e29872a1e61ef53b9f7df52796e4ddf0cd56b5d1fe88576b1615994ecf118  agora-model.json
+92416b6ec4ad35591aca1f804f1be30000780524e5a7a4c7ed0d3432c8d6d47f  README.md
+92df747507c7d2e90758f9626ec6db22c29976d74eac00088e75694d91792b96  agora-model.json
 18f549e98fe991bd403b898a524df64467d9a7a9cdad1d3849bcbd91b95e37fe  embedding.bin
 145406c1cb5760d4a705acae693b47e08ee63cbcde35fd86d4d18b92bb613414  frontend/config.json
 61690c227693ca614d6ec3449f5017520e6c9793aa06c9599c3be610a514d5a0  frontend/rows_const.npy

agora-model.json

@@ -58,6 +58,19 @@
       "approx_download_bytes": 3546296093
     }
   ],
-  "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"
+  "notes": "Global configuration contains only common deployment declarations. The project owns file filters and application options. Ubuntu selections do not qualify the entire native SDK/BSP stack; only QCS8550/Ubuntu22.04 is currently qualified.",
+  "configuration": "agora.env",
+  "global_parameters": [
+    "AGORA_WORKSPACE",
+    "AGORA_CONTENT_ID",
+    "AGORA_CODE_REPO",
+    "AGORA_CODE_REF",
+    "AGORA_RESOURCE_REPO",
+    "AGORA_RESOURCE_REF",
+    "AGORA_SOC",
+    "AGORA_OS",
+    "AGORA_OS_VERSION"
+  ],
+  "resource_selection": "https://github.com/APLUX-Agora/audio8-asr-infinite-demo/blob/main/agora/resources.env",
+  "audio_clock_source": "models.json:audio_clock_ms"
 }