Amica：您友好的个人AI

如果您喜欢我们的项目，请在GitHub上给我们点个赞⭐。

Amica让您能够与高度可定制的3D角色进行对话，这些角色可以通过自然的语音聊天和视觉交流互动，并配备情感引擎，使Amica能够表达情感等。您可以使用任何AI技术以任意方式自定义她。

在此处通过手机、平板或桌面端试用Amica

对于Windows用户：请在安装过程中为Amica创建一个新文件夹，以防止卸载时无意中删除其他文件。

我们刚刚发布了Amica 1.2版本，带来了许多新功能。文档也将很快进一步更新，观看视频了解Amica 1.2提供了哪些功能：

您可以导入VRM文件，调整声音以匹配角色，并生成包含情感表达的回复文本。

Amica的各项功能主要使用和支持以下技术：

如需查看如何将这些技术与Amica配合使用的教程，请访问Amica官方文档。

• 3D渲染
  • three.js
• 3D角色显示
  • @pixiv/three-vrm
• 在浏览器中运行Transformer模型
  • Transformers.js
• 语音识别
  • Whisper
• 语音活动检测
  • Silero VAD
• 聊天机器人
  • Llama.cpp服务器
  • ChatGPT API（兼容LM Studio等项目）
  • Window.ai
  • Ollama
  • KoboldCpp
  • Oobabooga
  • OpenRouter（可访问多种AI模型）
• 文本转语音
  • Eleven Labs API
  • Speech T5
  • OpenAI
  • Coqui（本地）
  • RVC
  • AllTalkTTS
• 视觉
  • Bakllava

🛠️ 安装与运行

要本地运行该项目，请克隆或下载仓库。

git clone git@github.com:semperai/amica.git

安装所需的依赖包。

npm install

安装完依赖后，使用以下命令启动开发Web服务器：

npm run dev

启动后，请访问以下URL以确认其正常运行。

http://localhost:3000

📝 配置

大多数配置都在.env.local文件中完成。可用选项请参考config.ts文件。

OpenRouter配置

要将OpenRouter用作聊天后端，请在.env.local文件中设置以下环境变量：

• NEXT_PUBLIC_OPENROUTER_APIKEY：您的OpenRouter API密钥（必填）
• NEXT_PUBLIC_OPENROUTER_URL：自定义OpenRouter API URL（可选，默认为https://openrouter.ai/api/v1）
• NEXT_PUBLIC_OPENROUTER_MODEL：默认OpenRouter模型（可选，默认为openai/gpt-3.5-turbo）

amica
├── .env.local
├── src
│   ├── utils
│   │   └── config.ts

📦 桌面应用

Amica使用Tauri来构建桌面应用程序。

要开发桌面应用程序，请使用以下命令：

npm run tauri dev

📖 文档

请查看文档，了解更多关于如何配置和使用Amica的信息。

📜 历史

该项目最初是Pixiv的ChatVRM的一个分支：

https://pixiv.github.io/ChatVRM

🔒 许可证

• 本项目的大部分内容根据LICENSE文件中的规定，采用MIT许可证发布。
• 诸如3D模型和图片等资源则根据其各自作者的许可证进行发布。

✨ 星标历史

🤗 贡献者

Amica 快速上手指南

Amica 是一款开源的个人 AI 助手，支持高度定制的 3D 角色交互。它具备自然语音聊天、视觉识别能力，并内置情感引擎，能让虚拟角色表达丰富的情感。项目基于 Web 技术构建，支持多种后端大模型（如 Llama.cpp, Ollama, OpenRouter 等）和语音方案。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统: Windows, macOS 或 Linux
• Node.js: 建议安装 LTS 版本 (v18+)
• npm: 随 Node.js 自动安装
• Git: 用于克隆代码仓库
• 浏览器: 推荐 Chrome 或 Edge (用于 Web 端运行)
• (可选) Rust & Cargo: 仅当您需要编译或开发桌面客户端 (基于 Tauri) 时需要安装

提示：国内开发者若遇到 npm 安装缓慢的问题，可临时切换至国内镜像源： npm config set registry https://registry.npmmirror.com

安装步骤

1. 克隆项目

将 Amica 源代码克隆到本地目录：

git clone git@github.com:semperai/amica.git
cd amica

2. 安装依赖

安装项目所需的 npm 包：

npm install

3. 配置环境变量

大多数配置需在 .env.local 文件中完成。您可以参考 src/utils/config.ts 查看可用选项。

如果您计划使用 OpenRouter 作为聊天后端，请在根目录创建 .env.local 文件并填入以下内容：

NEXT_PUBLIC_OPENROUTER_APIKEY=你的_OpenRouter_API_Key
NEXT_PUBLIC_OPENROUTER_URL=https://openrouter.ai/api/v1
NEXT_PUBLIC_OPENROUTER_MODEL=openai/gpt-3.5-turbo

注意：NEXT_PUBLIC_OPENROUTER_APIKEY 是必填项，其他两项可选。

基本使用

启动 Web 开发服务器

安装完成后，运行以下命令启动本地开发服务器：

npm run dev

启动成功后，在浏览器中访问：

http://localhost:3000

此时您应该能看到默认的 3D 角色界面。您可以尝试通过麦克风与角色进行语音对话，或在配置文件中替换 VRM 模型文件以自定义角色外观。

(可选) 开发桌面客户端

Amica 使用 Tauri 构建桌面应用。如需开发或测试桌面版，请运行：

npm run tauri dev

---

更多高级配置（如接入本地 Ollama、RVC 变声、Bakllava 视觉模型等），请参阅 官方文档。