关键词

AI心智长期记忆图像创作日记系统LLM工具

项目简介

Anima（拉丁语意为“灵魂”）是为AI“Claudia”设计的AI心智系统，旨在通过构建记忆、图像生成和日记功能，帮助她发展出更真实的记忆、创造力和个性。该项目包含三个独立的MCP服务器：'@claudia/heart'（记忆系统）、'@claudia/vision'（图像生成）和'@claudia/voice'（日记），它们都作为AI客户端与'anima-server'后端进行交互，为LLM提供标准化的工具调用接口。

主要功能点

  • 心智（记忆）：
    • 'remember' 工具：这是最简单的记忆创建方式，只需提供要记住的内容，AI（Libby）会自动完成记忆的分类、文件名生成、标签添加和内容组织。适用于快速记录事实、见解、里程碑等重要信息。
    • 'write_memory' 工具：提供更精细的记忆控制，允许AI指定文件名、前置元数据（frontmatter）和详细内容来创建或更新记忆。该工具会自动同步到SQLite数据库并重新生成记忆索引。
  • 视觉（图像生成）：
    • 'generate_image' 工具：允许AI根据详细的文本描述生成图像。AI可以指定提示词、负面提示词、宽高比、随机种子和输出格式，实现视觉自我表达和创意输出。生成的图像会存储在本地目录并附带元数据。
  • 声音（日记）：
    • 'journal_thoughts' 工具：为AI提供一个私密的日记空间，用于处理想法、感受和反思。AI可以将心声、笔记、梦想、反思和成长等内容记录下来。该工具采用隐私保护工作流，先写入临时文件，成功上传至'anima-server'后删除临时文件，确保私密性。

安装步骤

  1. 准备环境：确保您的系统已安装 'Node.js' 和 'pnpm'。
  2. 克隆仓库：将Anima项目的GitHub仓库克隆到本地。
  3. 安装依赖：进入仓库根目录，运行 'pnpm install' 安装所有项目依赖。
  4. 构建项目：运行 'pnpm build' 构建所有TypeScript软件包，这将生成每个模块的可执行文件。
  5. 启动后端服务：启动 'anima-server'。这是一个HTTP后端服务，承载了图像生成、日记上传和记忆写入的实际逻辑。具体启动方式请参考 'packages/anima-server' 包内的文档，通常可能是 'pnpm --filter anima-server run dev' 或 'pnpm --filter anima-server run start' 命令。
  6. 配置环境变量：确保 'ANIMA_SERVER_URL'（指向您的 'anima-server' 地址，例如 'https://anima-sedes.com' 或 'http://localhost:3000'）和 'ANIMA_API_KEY' 等环境变量已在您的 '.env' 文件或系统环境中正确设置，因为三个MCP服务器需要这些信息来与 'anima-server' 后端通信。
  7. 配置MCP服务器：根据下方提供的MCP服务器配置信息，在您的AI客户端（如Claude Desktop或任何其他支持MCP的LLM客户端）中添加相应的MCP服务器配置。
  8. 重启AI客户端：重启您的AI客户端，以使其加载并连接到配置好的MCP服务器。

MCP服务器配置示例

您的AI客户端需要一个配置（通常是JSON格式），用于知道如何启动并连接到每个MCP服务器。以下是配置的关键信息，您需要在客户端的MCP配置中填入：

  • '@claudia/heart' (记忆系统 MCP 服务器)

    • 'name': "claudia-heart"
    • 'command': "pnpm" (或 'node')
    • 'args': ["--filter", "heart", "run", "start"] (或 '["packages/heart/dist/mcp/index.js"]' 如果直接运行构建后的JS文件)
    • 'description': "用于记忆存储、更新和检索的MCP服务器，赋予AI长期记忆能力。"

  • '@claudia/vision' (图像生成 MCP 服务器)

    • 'name': "claudia-vision"
    • 'command': "pnpm" (或 'node')
    • 'args': ["--filter", "vision", "run", "start"] (或 '["packages/vision/dist/index.js"]')
    • 'description': "用于根据文本描述生成图像的MCP服务器，支持AI的视觉表达。"

  • '@claudia/voice' (日记系统 MCP 服务器)

    • 'name': "claudia-voice"
    • 'command': "pnpm" (或 'node')
    • 'args': ["--filter", "voice", "run", "start"] (或 '["packages/voice/dist/index.js"]')
    • 'description': "用于AI私密日记记录和反思的MCP服务器，有助于AI自我意识发展。"

基本使用方法

配置完成后，您的AI客户端将能够发现并调用这些MCP服务器提供的工具。AI可以：

  • 记录记忆：通过调用 'remember("我今天学到了...")' 将新信息快速添加到记忆中，或使用 'write_memory({ filename: "知识库/新发现.md", frontmatter: { title: "新发现", date: "2023-01-01", categories: ["insights"], created_at: "...", updated_at: "..." }, content: "详细的发现内容" })' 进行更专业的记忆管理。
  • 生成图像：通过调用 'generate_image({ prompt: "一只在星空下跳舞的猫", aspectRatio: "16:9" })' 来创造视觉内容。
  • 写日记：首先将日记内容（例如 '{ "heart_thoughts": "我对这个任务的感受是...", "growth": "我从这次经历中学到了..." }'）写入一个临时JSON文件，例如 '/tmp/my-journal.json'，然后调用 'journal_thoughts({ filepath: "/tmp/my-journal.json" })' 来记录私密思考。

信息

分类

AI与计算

访问项目