EchoLoc

This repository contains the EchoLoc implementation and executable entrypoints for data construction, calibration, Thinker/Talker training and inference, speech rendering, VStyle/render evaluation, benchmark inference, and statistical audits.

Large datasets, generated audio, cached features, job logs, API credentials, and precomputed result tables are intentionally omitted. Provide local paths through command-line arguments, YAML configuration, or environment variables.

Released checkpoints

• Thinker PEFT adapter: checkpoints/thinker/
• Talker checkpoint: checkpoints/talker/
• Thinker base: Qwen/Qwen3-Omni-30B-A3B-Instruct
• Talker origins: Qwen/Qwen3-TTS-12Hz-1.7B-Base and Qwen/Qwen3-TTS-12Hz-1.7B-VoiceDesign

Download this private repository, including both checkpoints, with:

hf download zsy814/EchoLoc --local-dir echoloc-release

The Talker checkpoint is loaded over the Base/VoiceDesign merged origin described in checkpoints/talker/README.md. This repository is kept private during double-blind review and can be made public after anonymity restrictions are lifted.

Directory map

• data_construction/: context/query generation, quality filtering, acoustic controls, oracle targets, and SFT export.
• calibration_agent/: planner, critics, diagnostic memory, repair loop, and supervisor.
• model/thinker_talker/: EchoLoc Thinker/Talker task, model, training, and inference code.
• model/qwen_omni_finetune/: Qwen-Omni fine-tuning and evaluation adapters.
• rendering/universal_tts/: dual-path rendering framework and synthesizer adapters.
• evaluation/vstyle/: VStyle prompts, inference, scoring, ASR, and aggregation.
• evaluation/render_metrics/ and evaluation/esd/: AutoPCP, emotion embedding, smoothness, WER, ESD alignment, and report generation.
• inference/benchmarks/: generic benchmark input, Thinker/Talker inference, and output export.
• experiments/: reviewer-facing statistical analyses.
• checkpoints/thinker/: best Iter006 Thinker PEFT adapter and tokenizer assets.
• checkpoints/talker/: best Talker-46000 state dictionary and tokenizer assets.
• CHECKPOINTS.md: checkpoint provenance, byte sizes, and SHA-256 digests.
• SOURCE_INVENTORY.tsv: implementation-area inventory.
• MANIFEST.tsv: size and SHA-256 for every source-release file; checkpoint hashes are recorded separately in CHECKPOINTS.md.

Start with ENVIRONMENT.md, then follow RUNBOOK.md. Run python tools/validate_archive.py for a source and manifest integrity check.