如何本地跑通 Airi：完整上手开源 AI 虚拟角色

如何本地跑通 Airi完整上手开源 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/airiProject AIRI 是一个自托管、开源的 AI 虚拟角色项目。它受 Neuro-sama 启发能实时语音聊天、能玩 MinecraftWeb、macOS、Windows 都能跑。目标不是做一个聊天框而是让一个有灵魂的虚拟角色真正住进你自己的设备模型、语音、性格全都归你管。从零到本地预览三步跑通先对齐环境。这是个 pnpm 工作区workspace简单说就是同一仓库下多个子包的统一调度层根目录package.json里钉死了 pnpm 版本.tool-versions文件里写着配套的 Node 版本。你用 mise 之类的版本管理器会自动读它没有就手动装同版本再开工。然后在仓库根目录依次跑三条命令git clone https://gitcode.com/GitHub_Trending/ai/airi终端静默跑完当前目录多出一个airi文件夹里面是 apps、packages、docs 这些子目录。cd airi pnpm i装完依赖会顺带把基础包构建一遍结尾滚过一大段 turbo 构建日志。注意这里如果最后报错九成是版本没对齐回到上一步检查。pnpm dev它启动的是网页端入口跑起来之后你会发现 vite 直接打出一个本地地址。浏览器打开就是主界面。还有一个容易忽略的点刚启动时角色不会自己说话你要在页面设置里填上 LLM 的 API Key相当于给她装上大脑之后才能正常对话。核心模块速读改代码先看这张表仓库目录很多但对跑通真正关键的只有这几个按需查阅就行路径一句话作用什么时候需要动它apps/stage-web网页端入口pnpm dev打开的就是它改界面、加页面、调角色展示效果时packages/core-agent核心逻辑模型调用、角色行为换 LLM 提供商、给角色加新技能时packages/pipelines-audio语音链路语音识别和合成的管道接新的 TTS / 语音识别服务时server/apps/api自托管后端账号、记忆、数据存储需要登录、多端同步等服务端能力时integrations/minecraft游戏集成她玩 Minecraft 的那套逻辑想教她玩别的游戏时每个模块里都有 README仓库自带的 Project AIRI 是什么 中文文档也讲了整体能力边界不确定改哪就先翻它。端口被占、装不上依赖常见卡点排查端口被占用。vite 默认用 5173被占时它会自动换一个空闲端口。别记端口号以控制台实际打印的地址为准确认谁在占着可以用lsof -i :5173看。依赖装不上或中途报错。先对 pnpm 和 Node 版本再看网络代理能否访问依赖源。安装输出很长错误摘要在最后几行直接看结尾比翻中间快。跑起来了但角色不回应。十有八九是配置问题LLM 的 Key 没填、或者接口地址填错。先在设置页把连接测试跑通再怀疑项目本身。其他更细的问题仓库里docs目录有完整中文文档也可以去项目官方社区提问比自己死磕快得多。【免费下载链接】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），仅供参考