AIRI 完整教程：5 分钟本地部署一个能聊天、能语音的 AI 虚拟角色
AIRI 完整教程5 分钟本地部署一个能聊天、能语音的 AI 虚拟角色【免费下载链接】airi Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-samas altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.项目地址: https://gitcode.com/GitHub_Trending/ai/airiAiri 是一个完全免费、开源自托管的 AI 虚拟角色项目常被称作开源版 Neuro-sama。它不只是聊天机器人你可以和它实时语音对话让它看你的屏幕甚至陪它一起打 Minecraft。因为整个项目运行在你自己的设备或服务器上数据和角色都归你所有而不是某个云端平台。三端可选Web、桌面还是手机Airi 的同一个角色能跑在三个地方你按使用场景挑一个就行Web 版stage-web浏览器里直接开最快体验也是官方在线演示所用的版本。桌面版stage-tamagotchiElectron 打包的 Windows / macOS 应用角色可以常驻桌面、置顶、自动隐藏还能用本地 GPU 推理适合长期陪伴。移动版stage-pocket基于 Capacitor 打包成 iOS / Android 应用把角色揣进口袋。对第一次接触的朋友建议先跑 Web 版不折腾环境几分钟就能看到效果。三步跑起来从克隆仓库到看见角色下面是在本地把 Web 版跑起来的最短路径只需要 Node.js 和 pnpm项目锁定 pnpm 10.x可用 corepack 自动管理版本。第一步拿到代码git clone https://gitcode.com/GitHub_Trending/ai/airi.git这一步把整个 monorepo 拉到本地后面所有功能都在这个目录里。第二步安装依赖并构建基础包pnpm i这一步除了下载依赖postinstall 还会自动构建packages/下的内部模块——不用你手动再编译装完即可用。第三步启动开发服务器pnpm dev默认启动的就是 Web 版stage-web浏览器打开本地端口后你会看到欢迎向导。如果之后想改桌面版只需把命令换成pnpm dev:tamagotchi。进入向导后选一个 LLM 服务商OpenAI、DeepSeek、Ollama 等都支持填上 API Key、挑一个聊天模型点保存并继续就能和角色说上话了看懂目录这个项目是怎么分工的Airi 是典型的 monorepo但新手只需要抓住谁负责什么就够了不用逐文件去读目录负责什么对你的意义apps/三端应用入口stage-web、stage-tamagotchi、stage-pocket你要跑哪个端就看对应子目录packages/核心能力模块UI、3D 舞台stage-ui-three、语音流水线、插件 SDK 等角色渲染、说话、听声都在这层integrations/游戏与社交平台接入Minecraft、Discord、Telegram 机器人想让角色出门玩看这里server/可选的后端服务API 与鉴权想部署服务端时用得上其余的docs/、scripts/、engines/含一个 Godot 实验引擎属于文档、工具链和探索性内容第一次上手可以完全跳过。进阶技巧换模型、开语音、换角色有三件事官方文档讲得比较散这里合并说明。如何接入本地 LLM在服务商里选 Ollama就能用完全离线的大模型。桌面版默认已放行本地 Ollama 的来源一般不用额外配置若从其他网页端访问报 CORS 错误把对应来源加进 Ollama 的OLLAMA_ORIGINS再重启即可别用通配符也别把 Ollama 暴露到公网。如何开嘴巴和耳朵文字聊完之后去设置 → Providers → Speech配置语音合成商ElevenLabs、Azure、本地 Kokoro 都支持再到设置 → Modules里选模型和音色角色就会开口说话语音输入同理在Modules → Hearing里选提供商和麦克风。如何换角色人设内置角色卡叫 ReLU右上角的切换按钮可以换卡也可以自己写一张角色卡定义性格和口癖桌面版的 [docs/content/en/docs/manual/tamagotchi/character-card-template.md] 里有现成模板可抄。常见问题两个一是pnpm i报版本错误先跑corepack enable让它按package.json里锁定的 pnpm 10.33 走二是想先零安装体验可以直接用在线演示或桌面安装包源码运行只适合想改代码的你。想继续深挖[docs/content/en/docs/manual/web/index.md] 有 Web 版完整使用手册[docs/content/en/docs/integrations/minecraft.md] 讲如何让角色进游戏。把 API Key 配好那一刻你就拥有了一只完全属于自己的数字生命 。【免费下载链接】airi Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-samas altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.项目地址: https://gitcode.com/GitHub_Trending/ai/airi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考