Instructions to use leeting770708/h3-audio-models with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Diffusion Single File
How to use leeting770708/h3-audio-models with Diffusion Single File:
# No code snippets available yet for this library. # To use this model, check the repository files and the library's documentation. # Want to help? PRs adding snippets are welcome at: # https://github.com/huggingface/huggingface.js
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use leeting770708/h3-audio-models with llama.cpp:
Install (macOS, Linux)
curl -LsSf https://llama.app/install.sh | sh # Start a local OpenAI-compatible server with a web UI: llama serve -hf leeting770708/h3-audio-models:Q4_K_M # Run inference directly in the terminal: llama cli -hf leeting770708/h3-audio-models:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf leeting770708/h3-audio-models:Q4_K_M # Run inference directly in the terminal: llama cli -hf leeting770708/h3-audio-models:Q4_K_M
Use pre-built binary
# Download pre-built binary from: # https://github.com/ggerganov/llama.cpp/releases # Start a local OpenAI-compatible server with a web UI: ./llama-server -hf leeting770708/h3-audio-models:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf leeting770708/h3-audio-models:Q4_K_M
Build from source code
git clone https://github.com/ggerganov/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-server llama-cli # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama-server -hf leeting770708/h3-audio-models:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf leeting770708/h3-audio-models:Q4_K_M
Use Docker
docker model run hf.co/leeting770708/h3-audio-models:Q4_K_M
- LM Studio
- Jan
- Ollama
How to use leeting770708/h3-audio-models with Ollama:
ollama run hf.co/leeting770708/h3-audio-models:Q4_K_M
- Unsloth Studio
How to use leeting770708/h3-audio-models with Unsloth Studio:
Install Unsloth Studio (macOS, Linux, WSL)
curl -fsSL https://unsloth.ai/install.sh | sh # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for leeting770708/h3-audio-models to start chatting
Install Unsloth Studio (Windows)
irm https://unsloth.ai/install.ps1 | iex # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for leeting770708/h3-audio-models to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for leeting770708/h3-audio-models to start chatting
- Pi
How to use leeting770708/h3-audio-models with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf leeting770708/h3-audio-models:Q4_K_M
Configure the model in Pi
# Install Pi: npm install -g @mariozechner/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "llama-cpp": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "leeting770708/h3-audio-models:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use leeting770708/h3-audio-models with Docker Model Runner:
docker model run hf.co/leeting770708/h3-audio-models:Q4_K_M
- Lemonade
How to use leeting770708/h3-audio-models with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull leeting770708/h3-audio-models:Q4_K_M
Run and chat with the model
lemonade run user.h3-audio-models-Q4_K_M
List all available models
lemonade list
- Hermes Agent
How to use leeting770708/h3-audio-models with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf leeting770708/h3-audio-models:Q4_K_M
Configure Hermes
# Install Hermes: curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash hermes setup # Point Hermes at the local server: hermes config set model.provider custom hermes config set model.base_url http://127.0.0.1:8080/v1 hermes config set model.default leeting770708/h3-audio-models:Q4_K_M
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use leeting770708/h3-audio-models with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf leeting770708/h3-audio-models:Q4_K_M
Configure OpenClaw
# Install OpenClaw: npm install -g openclaw@latest # Register the local server and set it as the default model: openclaw onboard --non-interactive --mode local \ --auth-choice custom-api-key \ --custom-base-url http://127.0.0.1:8080/v1 \ --custom-model-id "leeting770708/h3-audio-models:Q4_K_M" \ --custom-provider-id llama-cpp \ --custom-compatibility openai \ --custom-text-input \ --accept-risk \ --skip-health
Run OpenClaw
openclaw agent --local --agent main --message "Hello from Hugging Face"
Copy files from models/Comfy-Org/ace_step_1.5_ComfyUI_files
Browse files- .gitattributes +0 -2
- README.md +33 -31
- checkpoints/ace_step_1.5_turbo_aio.safetensors +3 -0
- split_files/diffusion_models/acestep_v1.5_base.safetensors +3 -0
- split_files/diffusion_models/acestep_v1.5_turbo.safetensors +3 -0
- split_files/diffusion_models/acestep_v1.5_xl_base_bf16.safetensors +3 -0
- split_files/diffusion_models/acestep_v1.5_xl_sft_bf16.safetensors +3 -0
- split_files/diffusion_models/acestep_v1.5_xl_turbo_bf16.safetensors +3 -0
- split_files/text_encoders/qwen_0.6b_ace15.safetensors +3 -0
- split_files/text_encoders/qwen_1.7b_ace15.safetensors +3 -0
- split_files/text_encoders/qwen_4b_ace15.safetensors +3 -0
- split_files/vae/ace_1.5_vae.safetensors +3 -0
.gitattributes
CHANGED
|
@@ -33,5 +33,3 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
|
|
| 33 |
*.zip filter=lfs diff=lfs merge=lfs -text
|
| 34 |
*.zst filter=lfs diff=lfs merge=lfs -text
|
| 35 |
*tfevents* filter=lfs diff=lfs merge=lfs -text
|
| 36 |
-
model_structure.png filter=lfs diff=lfs merge=lfs -text
|
| 37 |
-
teaser.png filter=lfs diff=lfs merge=lfs -text
|
|
|
|
| 33 |
*.zip filter=lfs diff=lfs merge=lfs -text
|
| 34 |
*.zst filter=lfs diff=lfs merge=lfs -text
|
| 35 |
*tfevents* filter=lfs diff=lfs merge=lfs -text
|
|
|
|
|
|
README.md
CHANGED
|
@@ -1,37 +1,39 @@
|
|
| 1 |
---
|
| 2 |
license: apache-2.0
|
| 3 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
| 4 |
---
|
| 5 |
|
| 6 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 7 |
|
| 8 |
-
|
| 9 |
-
|
| 10 |
-
Paper: https://huggingface.co/papers/2506.21448
|
| 11 |
-
|
| 12 |
-
Github: https://github.com/FunAudioLLM/ThinkSound
|
| 13 |
-
|
| 14 |
-
<img src="./teaser.png" alt="model_structure" style="zoom:20%;" />
|
| 15 |
-
|
| 16 |
-
## Abstract
|
| 17 |
-
While end-to-end video-to-audio generation has greatly improved, producing high-fidelity audio that authentically captures the nuances of visual content remains challenging. Like professionals in the creative industries, such generation requires sophisticated reasoning about items such as visual dynamics, acoustic environments, and temporal relationships. We present ThinkSound, a novel framework that leverages Chain-of-Thought (CoT) reasoning to enable stepwise, interactive audio generation and editing for videos. Our approach decomposes the process into three complementary stages: foundational foley generation that creates semantically coherent soundscapes, interactive object-centric refinement through precise user interactions, and targeted editing guided by natural language instructions. At each stage, a multimodal large language model generates contextually aligned CoT reasoning that guides a unified audio foundation model. Furthermore, we introduce AudioCoT, a comprehensive dataset with structured reasoning annotations that establishes connections between visual content, textual descriptions, and sound synthesis. Experiments demonstrate that ThinkSound achieves state-of-the-art performance in video-to-audio generation across both audio metrics and CoT metrics and excels in out-of-distribution Movie Gen Audio benchmark. The demo page is available at https://ThinkSound-Project.github.io.
|
| 18 |
-
|
| 19 |
-
## Model Overview
|
| 20 |
-
|
| 21 |
-
<img src="./model_structure.png" alt="model_structure" style="zoom:40%;" />
|
| 22 |
-
|
| 23 |
-
## Citation
|
| 24 |
-
|
| 25 |
-
If you find our work useful, please cite our paper:
|
| 26 |
|
| 27 |
-
|
| 28 |
-
@misc{liu2025thinksoundchainofthoughtreasoningmultimodal,
|
| 29 |
-
title={ThinkSound: Chain-of-Thought Reasoning in Multimodal Large Language Models for Audio Generation and Editing},
|
| 30 |
-
author={Huadai Liu and Jialei Wang and Kaicheng Luo and Wen Wang and Qian Chen and Zhou Zhao and Wei Xue},
|
| 31 |
-
year={2025},
|
| 32 |
-
eprint={2506.21448},
|
| 33 |
-
archivePrefix={arXiv},
|
| 34 |
-
primaryClass={eess.AS},
|
| 35 |
-
url={https://arxiv.org/abs/2506.21448},
|
| 36 |
-
}
|
| 37 |
-
```
|
|
|
|
| 1 |
---
|
| 2 |
license: apache-2.0
|
| 3 |
+
tags:
|
| 4 |
+
- comfyui
|
| 5 |
+
- diffusion-single-file
|
| 6 |
+
base_model:
|
| 7 |
+
- ACE-Step/Ace-Step1.5
|
| 8 |
---
|
| 9 |
|
| 10 |
+
# ACE-Step 1.5
|
| 11 |
+
|
| 12 |
+
Repackaged model files for ComfyUI.
|
| 13 |
+
|
| 14 |
+
Original model repository: https://huggingface.co/ACE-Step/Ace-Step1.5
|
| 15 |
+
|
| 16 |
+
Place the files in the following folders:
|
| 17 |
+
|
| 18 |
+
```
|
| 19 |
+
π ComfyUI/
|
| 20 |
+
βββ π models/
|
| 21 |
+
β βββ π checkpoints/
|
| 22 |
+
β β βββ ace_step_1.5_turbo_aio.safetensors
|
| 23 |
+
β βββ π diffusion_models/
|
| 24 |
+
β β βββ acestep_v1.5_base.safetensors
|
| 25 |
+
β β βββ acestep_v1.5_turbo.safetensors
|
| 26 |
+
β β βββ acestep_v1.5_xl_base_bf16.safetensors
|
| 27 |
+
β β βββ acestep_v1.5_xl_sft_bf16.safetensors
|
| 28 |
+
β β βββ acestep_v1.5_xl_turbo_bf16.safetensors
|
| 29 |
+
β βββ π text_encoders/
|
| 30 |
+
β β βββ qwen_0.6b_ace15.safetensors
|
| 31 |
+
β β βββ qwen_1.7b_ace15.safetensors
|
| 32 |
+
β β βββ qwen_4b_ace15.safetensors
|
| 33 |
+
β βββ π vae/
|
| 34 |
+
β β βββ ace_1.5_vae.safetensors
|
| 35 |
+
```
|
| 36 |
|
| 37 |
+
---
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 38 |
|
| 39 |
+
These are repackaged files to work with ComfyUI, original model repo is: https://huggingface.co/ACE-Step/Ace-Step1.5
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
checkpoints/ace_step_1.5_turbo_aio.safetensors
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:67b0f43aa5c51c840bd0228e6a935d8ff416ec87e5df2fc0637da17a561252bc
|
| 3 |
+
size 10025478736
|
split_files/diffusion_models/acestep_v1.5_base.safetensors
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:4177f600501a6d4bd81cadaa0abac557ffd15c54e5c8cb52053cdb24a0844d6b
|
| 3 |
+
size 4787825604
|
split_files/diffusion_models/acestep_v1.5_turbo.safetensors
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:3f6e0797fad420a39bd33979eb6e840e30989e34a3794e843d23b60ec6e422d7
|
| 3 |
+
size 4787825604
|
split_files/diffusion_models/acestep_v1.5_xl_base_bf16.safetensors
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:56bf816fc9a69a5f45635e867b2ad742e1e648eb51fadb7d124cb8332d2e0940
|
| 3 |
+
size 9974719930
|
split_files/diffusion_models/acestep_v1.5_xl_sft_bf16.safetensors
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:3c05ae268353b3540fb1fd7db4fd77ffbda9802ec641b624e15648e030ecf3ce
|
| 3 |
+
size 9974719930
|
split_files/diffusion_models/acestep_v1.5_xl_turbo_bf16.safetensors
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:86a1afb0a1f711f0e3304ff65d874df3ae6783db683dcf982513fb9b6d14ae71
|
| 3 |
+
size 9974719892
|
split_files/text_encoders/qwen_0.6b_ace15.safetensors
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:fd4590c82153b8ddb67e15a2e7aaa8afa8b83a858c8a9b82a4831063156aa7a7
|
| 3 |
+
size 1191588248
|
split_files/text_encoders/qwen_1.7b_ace15.safetensors
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:ed63e9247d1f55f3ace04fa11e95b085fc82d459c82c5626f0b2e37b91ebd710
|
| 3 |
+
size 3708523360
|
split_files/text_encoders/qwen_4b_ace15.safetensors
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:ffe5ffb855086c2ab55e467e9859fb01894781020a0376484dd19de166b79873
|
| 3 |
+
size 8379154232
|
split_files/vae/ace_1.5_vae.safetensors
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:6de92e3a862acd287e08b024ac90f0783a8635451b728721a33ff03565bcb2bb
|
| 3 |
+
size 337431732
|