TalkingHead

给 3D 角色一键加上自然说话口型，实时驱动虚拟人。

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署音频音乐 🍴 复刻 367 🐛 待处理 7 👀 关注 25

GitHub ↗

GitHub 星标 ★ 1667

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，MIT许可证，完全免费，可自行部署使用。

项目预览

TalkingHead 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类音频音乐

开发团队met4citizen

GitHubhttps://github.com/met4citizen/TalkingHead

定价模式🏷️完全免费

价格说明开源项目，MIT许可证，完全免费，可自行部署使用。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言JavaScript

技术栈/模型3d-avatar,lip-sync,talking-avatar,talking-head,text-to-speech

GitHub 星标★ 1667

上线时间2023-08-14 00:00:00

代码更新2026-11-04

仓库体积91.5 MB

本站数据更新2026-11-09

维护状态活跃

收录时间2026-08-09

浏览次数5

项目介绍

TalkingHead 是一个基于 JavaScript 的实时口型同步类库，专门用于驱动全身 3D 虚拟形象说话。它解决了开发者快速为 3D 角色添加自然说话动画的难题，无需手动制作复杂的口型和表情动画。核心能力包括：加载 3D 模型、接收文本或音频输入、自动生成与语音同步的口型、眨眼和头部微动，并支持实时渲染。项目采用模块化设计，易于集成到网页或应用中，适合虚拟主播、数字人客服、游戏 NPC 对话等场景。其技术栈聚焦于 3D 头像与 TTS 的融合，目前仍在成长中，社区活跃度尚可。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1667

技术标签

lip-sync talking-head text-to-speech

使用教程

⚠ 本教程由 AI 依据该项目 README 整理；原始文档不完整，部分步骤为通用流程推断，实际安装请以项目官方文档为准。

难度：进阶约 30 分钟部署方式：库/依赖 5 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

现代浏览器，官方演示均在 Chrome 中实时录制，推荐使用 Chrome
从 GitHub 获取的 TalkingHead 仓库源码
准备好用于驱动口型的文本或音频素材（如 MP3）

安装与启动步骤

1获取项目源码

从 GitHub 克隆仓库到本地，README 未提供 npm 包安装命令，以源码方式使用。
```
git clone https://github.com/met4citizen/TalkingHead.git
```
2阅读仓库文档

README 节选只有演示视频，实际安装与 API 说明需查看仓库完整文档和示例目录。
3启动测试页面

用你惯用的静态文件服务器托管仓库，打开其中的 TalkingHead 测试网页；README 未给出具体命令。
4用 Chrome 验证效果

在 Chrome 中打开测试页，观察 3D 头像是否实时说话、口型是否与语音同步。
5接入自己的项目

在页面中加载 3D 模型，接入文本或音频输入，调用口型同步与 speakAudio 等接口。