项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1623
使用教程
环境要求
- 已安装 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
下一篇:DigitalLife
同类项目推荐
-Prototype-AIVTuber
开源
用GPT-3和VTuber引擎,快速搭建AI虚拟主播,实现直播自动互动。
a open-source Artificial Intelligence Virtual Youtuber (AI VTuber), (this project is···
utsuwa
开源
打造专属 AI 伴侣,陪你聊天一起成长
Utsuwa is an open-source alternative to Grok Companion. This is a platform where you···
GameFactory-3A
开源
一条命令生成 3A 游戏资产,从模型到视频全自动
A comprehensive open-source 3A game-generation skill and asset framework.
几分钟生成一个主播,24 小时替你出镜带货。
AI Avatar/Anchor: create video from plain text or audio file in minutes, support up ···
FlexiDreamer
开源
单张照片秒变 3D 模型,用 FlexiCubes 快速生成网格。
An official implementation of FlexiDreamer: Single Image-to-3D Generation with Flexi···
一张照片加一段声音,秒变会说话的数字人。
AI Avatar / digital human platform — upload a photo, clone a voice, talk to any fac···
xiaokeai
开源
桌面 3D 角色陪你语音聊天,还会抽塔罗
Open-source 3D AI companion and transparent desktop pet. Also: 开源 3D AI 伴侣, 本地···
ComfyUI-Trellis2
开源
在 ComfyUI 里拖节点,把图片直接变成带纹理的 3D 模型
ComfyUI Wrapper for Microsoft Trellis.2 - Native and Compact Structured Latents for ···
CraftsMan3D
开源
从图片或文字一键生成可编辑的高保真 3D 网格
CraftsMan: High-fidelity Mesh Generation with 3D Native Diffusion and Interactive Ge···
