Vocabulary

Help me install and verify Vocabulary on my computer.
Project repository: https://github.com/itopinion/zectrix-vocabulary
Installation guide: https://github.com/itopinion/zectrix-vocabulary/blob/main/README.md
Site review date: 2026-10-17; reference commit: b0962e5ad5073cde9ea6aa59b6d3624cc47c5319. Recheck the current version before execution.
Project requirements: Build for your system · Compatible Hub · Local speech components · NOTE4
Distribution status: Build from source · Adapt for your system
The app source is public. Hub has not been officially released; its repository and bundled device SDK remain private.
Common device SDK source: https://github.com/itopinion/zectrix-hub/tree/main/crates/zectrix-cards/vendor/sdk (currently in a private repository; access required).
Cross-platform guide: https://github.com/itopinion/zectrix-hub/blob/main/docs/PORTING.md. Check compatibility between the current SDK and device firmware; do not blindly use versions from old documentation.
Identify the operating system, processor architecture and build toolchain first. Build from project source and the matching SDK for this system; do not download or distribute prebuilt Mac app packages. Create an isolated runtime for Python projects on the target system.

Prepare the shared connection helper first, then install the app:
1. Check whether ZECTRIX Hub (https://github.com/itopinion/zectrix-hub) is already installed, including its running status, version and app interfaces. Reuse a compatible installation; do not reinstall, overwrite existing apps, settings or data, or open a competing device connection.
2. If Hub is missing, first confirm access to Hub and matching SDK source. Hub has not been officially released and its repository is private. Without access, explain the unavailable dependency and pause device installation. Do not request tokens in chat or change repository visibility.
3. If Hub exists but is incompatible, explain the differences and upgrade plan first and preserve existing data. Check the exact compatibility between Hub's bundled SDK and device firmware. Do not infer compatibility solely from an old README's minimum version, or automatically flash or replace firmware. NOTE4C is outside this app's scope.
4. Put NOTE4 and the computer on the same LAN and enter local push mode. Let Hub discover and select the device and hold the connection. This flow does not require a ZECTRIX Cloud API Key or manually entering a MAC first.

Installation and usage steps for this project:
1. Check the system and connection helper: Ask AI to identify the OS and processor architecture and reuse a compatible Hub. If missing, first confirm access to Hub and matching SDK source, then build for this system; without access, pause device installation. Check SDK and NOTE4 firmware compatibility and preserve existing apps and data.
2. Build Vocabulary from source: ask AI to build for this system and connect to Hub. The reference speech-recognition implementation depends on Apple Silicon / MLX. Windows, Linux and NAS systems need a suitable speech backend; verify text exercises before read-aloud and recognition.
3. Start with a small vocabulary set: import a word list you are authorized to use, then choose a textbook and unit. Check hints, press-and-hold spelling, whole-word pronunciation and model answers. Import the full vocabulary only after testing.
The app works through Hub Runtime API. The connection layer uses the device SDK; downloading the SDK alone does not replace Hub. Check platform-specific paths, process management, build dependencies and speech backends, adapting as needed. Successful compilation does not verify cross-platform functionality.

First verification: Complete one round of Chinese hints, letter-by-letter spelling, whole-word pronunciation and model answers on NOTE4. Verify the vocabulary remains after restarting the app.
Report program startup, image generation, device reception and physical-screen verification separately. Do not treat successful simulation as real-device verification. Explain installation location, how to restart and stop, and limits when the computer or network disconnects.
Keep keys, Hub credentials, accounts and personal data in local configuration only, never shared tasks or logs. If this AI has no local execution environment, provide reviewable local installation steps first; do not claim installation is complete.