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)