This repository provides the code for the FAC-FACodec project.
Listen to samples on our Demo Page
FAC-FACodec
Accepted at ICASSP 2026
git clone https://github.com/claussss/FAC-FACodec.git
cd Controlled_AC
Clone Amphion at the same directory level as this repository:
cd ..
git clone https://github.com/open-mmlab/Amphion.git
cd Controlled_AC
conda create -n facodec python=3.11.11
conda activate facodec
pip install -r requirements.txt
Download the pretrained model and normalization statistics from:
π₯ Google Drive
The download contains two directories:
stats/ - Normalization statistics (mean/std for zc1 and zc2)weights/ - Model checkpointPlace them in your project:
Controlled_AC/
βββ checkpoints/
β βββ <your_checkpoint>.pt # from weights/
βββ stats/
β βββ mean_zc1_indx.pt
β βββ std_zc1_indx.pt
β βββ mean_zc2_indx.pt
β βββ std_zc2_indx.pt
βββ ...
Copy the example config and update paths:
cp FACodec_AC/config.py.example FACodec_AC/config.py
Edit FACodec_AC/config.py with your local paths.
See inference_demo.ipynb for a step-by-step guide on running inference with the pretrained model.
The notebook demonstrates:
Download LJSpeech
wget https://data.keithito.com/data/speech/LJSpeech-1.1.tar.bz2
tar xfj LJSpeech-1.1.tar.bz2
Generate FACodec Dataset
python create_facodec_dataset.py
This creates .pt files with FACodec indices (prosody_indx, zc1_indx, zc2_indx, etc.)
Generate Phone Forced Alignment Data
python create_phone_dataset.py
python train.py
Training progress and checkpoints are saved to tensorboard/ and checkpoints/ respectively.
Controlled_AC/
βββ FACodec_AC/
β βββ config.py.example # Configuration template (copy to config.py)
β βββ models.py # Denoising transformer model
β βββ dataset.py # Dataset and dataloader utilities
β βββ utils.py # Utility functions
βββ create_facodec_dataset.py # FACodec feature extraction
βββ create_phone_dataset.py # Phoneme forced alignment
βββ train.py # Training script
βββ inference_demo.ipynb # Inference demonstration
βββ requirements.txt
Citation information will be available upon publication.
This project is released under the MIT License.
4 commits
Python
73.0%
Jupyter Notebook
27.0%
This repository provides the code for the FAC-FACodec project.
Listen to samples on our Demo Page
FAC-FACodec
Accepted at ICASSP 2026
git clone https://github.com/claussss/FAC-FACodec.git
cd Controlled_AC
Clone Amphion at the same directory level as this repository:
cd ..
git clone https://github.com/open-mmlab/Amphion.git
cd Controlled_AC
conda create -n facodec python=3.11.11
conda activate facodec
pip install -r requirements.txt
Download the pretrained model and normalization statistics from:
π₯ Google Drive
The download contains two directories:
stats/ - Normalization statistics (mean/std for zc1 and zc2)weights/ - Model checkpointPlace them in your project:
Controlled_AC/
βββ checkpoints/
β βββ <your_checkpoint>.pt # from weights/
βββ stats/
β βββ mean_zc1_indx.pt
β βββ std_zc1_indx.pt
β βββ mean_zc2_indx.pt
β βββ std_zc2_indx.pt
βββ ...
Copy the example config and update paths:
cp FACodec_AC/config.py.example FACodec_AC/config.py
Edit FACodec_AC/config.py with your local paths.
See inference_demo.ipynb for a step-by-step guide on running inference with the pretrained model.
The notebook demonstrates:
Download LJSpeech
wget https://data.keithito.com/data/speech/LJSpeech-1.1.tar.bz2
tar xfj LJSpeech-1.1.tar.bz2
Generate FACodec Dataset
python create_facodec_dataset.py
This creates .pt files with FACodec indices (prosody_indx, zc1_indx, zc2_indx, etc.)
Generate Phone Forced Alignment Data
python create_phone_dataset.py
python train.py
Training progress and checkpoints are saved to tensorboard/ and checkpoints/ respectively.
Controlled_AC/
βββ FACodec_AC/
β βββ config.py.example # Configuration template (copy to config.py)
β βββ models.py # Denoising transformer model
β βββ dataset.py # Dataset and dataloader utilities
β βββ utils.py # Utility functions
βββ create_facodec_dataset.py # FACodec feature extraction
βββ create_phone_dataset.py # Phoneme forced alignment
βββ train.py # Training script
βββ inference_demo.ipynb # Inference demonstration
βββ requirements.txt
Citation information will be available upon publication.
This project is released under the MIT License.
4 commits
Python
73.0%
Jupyter Notebook
27.0%