agnai 本地部署与使用教程

agnai 本地部署与使用教程

Contents

• 简介
• 前置准备
• 分步教程
• 去哪找角色卡
• 常见问题排查

简介

本教程介绍如何本地部署和运行 agnai（开源 AI 角色扮演聊天平台），适合希望自托管或开发自定义功能的用户。包含 Docker/NPM 安装、基础功能配置及问题排查指南。

前置准备

• 环境要求：
  • Node.js（LTS 版本）
  • 可选：MongoDB（用于持久化数据）
  • 可选：Redis（多节点通信）
• 账号：无需注册即可匿名使用（数据仅存储于浏览器本地）

分步教程

方法一：Docker 部署（推荐）

1. 安装 Docker
2. 执行命令：

   docker compose -p agnai -f self-host.docker-compose.yml up -d
   

3. 访问 http://localhost:3001，初始账号：admin/password

方法二：NPM 全局安装

1. 安装 Node.js 和 MongoDB
2. 执行：

   npm install agnai -g
   agnai
   

3. 数据存储路径：
   • Linux/Mac: ~/.agnai
   • Windows: C:\Users\[用户名]\.agnai

开发模式运行

1. 克隆仓库：

   git clone https://github.com/agnaistic/agnai
   

2. 安装依赖：

   npm run deps
   npm run build:all
   

3. 启动：
   • Mac/Linux: npm start
   • Windows: npm run start:win

去哪找角色卡

• 优先推荐：
  • RisuRealm（支持多格式导入）
  • Character Tavern（策展优质）
• 最大库（注意分级）：
  • Chub.ai（需开启 SFW 过滤）
  • JanitorAI（需年龄验证）

免责声明：角色卡为用户生成内容，请遵守各平台条款并启用 SFW 过滤。

常见问题排查

FAQ

Q: 本地部署能否使用订阅模型？

A: 目前仅限在线服务使用订阅模型，本地版本需自行配置第三方 AI 服务（如 OpenAI/Kobold）。

Q: 数据如何备份？

A: MongoDB 用户需备份数据库文件，匿名模式数据存储在浏览器本地。

Q: 支持哪些 AI 服务？

A: 包括 Kobold/NovelAI/OpenAI/Claude/OpenRouter 等，配置路径：设置 > AI 服务。

探索更多功能 → tuniang.ai

## Sources

- [agnai](https://www.npmjs.com/package/agnai/v/1.0.403?activeTab=dependencies#1)
- [https://raw.githubusercontent.com/acidbubbles/agn-ai/refs/heads/dev/README.md#1](https://raw.githubusercontent.com/acidbubbles/agn-ai/refs/heads/dev/README.md#1)