amica

让 3D 角色开口说话，打造沉浸式语音交互体验

Amica 是一个开源的 3D 角色交互界面，旨在让用户通过语音与虚拟角色进行自然对话。它解决了传统聊天机器人缺乏沉浸感和多模态交互的问题，将语音识别、语音合成、大语言模型和 3D 渲染技术整合在一起。核心能力包括：实时语音对话、面部表情和口型同步、支持多种 LLM 后端（如 OpenAI、本地模型）、可定制角色外观和性格、以及基于浏览器的跨平台运行。用户可以通过简单的配置创建自己的虚拟助手或数字人，用于教育、娱乐、客户服务等场景。项目采用 TypeScript 开发，社区活跃，持续迭代中。

开源 unknown 音频音乐

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1598

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类音频音乐

开发团队semperai

所属国家

官网地址https://heyamica.com

GitHubhttps://github.com/semperai/amica

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型ai,assistant-chat-bots,computer-vision,llm,speech-recognition,tts

GitHub 星标★ 1598

30天Star增速

HF 下载量

上线时间2023-10-29 00:00:00

最近更新2026-09-20 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 10 分钟部署方式：本地安装 6 步

环境要求

已安装 Git，可克隆仓库
已安装 Node.js 与 npm（用于 npm install / npm run dev）
本地 3000 端口可用（默认访问地址为 http://localhost:3000）
如需使用 OpenRouter 聊天后端，需准备 OpenRouter API Key

安装与启动步骤

1克隆仓库

从 GitHub 克隆 amica 源码到本地，README 给出的是 SSH 地址形式。
```
git clone git@github.com:semperai/amica.git
```
2进入项目目录

克隆完成后进入 amica 目录，后续命令都在此目录执行。
```
cd amica
```
3安装依赖

安装项目所需的 npm 包，耗时取决于网络环境，请耐心等待。
```
npm install
```
4配置环境变量

在项目根目录创建 .env.local，按需填入 OpenRouter 相关变量；可用选项参考 src/utils/config.ts。
5启动开发服务器

运行开发模式启动 Web 服务，启动后默认监听本地 3000 端口。
```
npm run dev
```
6浏览器访问验证

打开浏览器访问本地地址，确认 3D 角色界面能正常加载。

关键配置

配置项	必填	说明	示例
`NEXT_PUBLIC_OPENROUTER_APIKEY`	是	使用 OpenRouter 作为聊天后端时的 API 密钥	`sk-xxxxxxxxxxxxxxxx`
`NEXT_PUBLIC_OPENROUTER_URL`	否	自定义 OpenRouter API 地址，不填则用默认值	`https://openrouter.ai/api/v1`
`NEXT_PUBLIC_OPENROUTER_MODEL`	否	默认使用的 OpenRouter 模型，不填则为 openai/gpt-3.5-turbo	`openai/gpt-3.5-turbo`

如何确认成功

浏览器打开 http://localhost:3000，能看到 Amica 界面正常加载即表示启动成功。

常见问题

Q：怎样接入 OpenRouter 作为聊天后端？

A：在项目根目录的 .env.local 中设置 NEXT_PUBLIC_OPENROUTER_APIKEY，可选设置 NEXT_PUBLIC_OPENROUTER_URL 与 NEXT_PUBLIC_OPENROUTER_MODEL。

Q：在哪里查看全部可配置项？

A：README 提示参考仓库中的 src/utils/config.ts 文件，其中列出了可用的配置选项。

Q：Windows 用户安装时要注意什么？

A：README 建议安装时新建一个专用文件夹，避免卸载过程中误删其他文件。

Q：没有配置任何 API Key 能运行吗？

A：README 未说明无密钥时的行为，可先按步骤启动服务访问页面，再按官方文档 docs.heyamica.com 配置所需后端。

注意事项

README 给出的是 git clone 的 SSH 地址，若未配置 SSH 密钥可改用 GitHub 页面上的 HTTPS 地址克隆。
Windows 用户请单独建一个文件夹安装 Amica，防止卸载时误删其他文件。
更多功能配置教程见官方文档 https://docs.heyamica.com/。
也可以直接在线体验：https://amica.arbius.ai

核心亮点

集成语音识别、TTS 和 LLM，开箱即用的多模态对话流程
支持 3D 角色面部表情和口型同步，交互生动自然
兼容多种 LLM 后端，可本地部署也可接入云端 API

不足之处

3D 角色定制能力有限，复杂模型导入和动画调整需额外开发
文档/社区待观察

适用场景

虚拟客服/前台，提供拟人化语音服务
教育领域，创建互动式虚拟教师或讲解员
娱乐社交，打造个性化 AI 虚拟伙伴

替代项目

three.js、Babylon.js、Rive

项目介绍

amica 是数字人3D领域的开源项目，由 semperai 开发，2023 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（1,598）位列前 30%，在数字人3D分类的 272 个项目里位列前 14%。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-20。从国内网络环境看，当前已无法正常访问。

它主要面向的使用场景是：虚拟客服/前台，提供拟人化语音服务。同类可对比的替代方案包括 three.js、Babylon.js、Rive。

上一篇：aafactory-prototype

下一篇：DigitalLife