alfredfrancis/ai-chatbot-framework

解决的问题

本项目提供了一个私有的、自托管的 AI 助手环境。它解决了在确保交互保持在安全、隔离的工作空间内的同时，管理 AI 智能体对个人文件、自定义技能和外部应用程序数据访问权限的问题。

工作原理

每位用户都会被分配一个私有的 Docker 容器，作为智能体的沙盒。智能体使用一套核心工具（读取、写入、编辑和执行 bash 命令）来与你的工作空间进行交互。它通过可以读取和更新的纯文本文件（context.md 和 memory.md）来管理自己的记忆和上下文。你可以通过上传自定义技能或通过 Model Context Protocol (MCP) 连接外部服务来扩展智能体的能力，MCP 支持 OAuth 以进行安全身份验证。

适用人群

它适用于希望拥有一个能够持久访问其个人文件和工具的 AI 助手的个人，以及希望自托管支持 Agent Client Protocol (ACP) 以便与其他应用程序和编辑器集成的智能体环境的开发者。

亮点

• 私有沙盒： 每位用户都会获得一个专用的、隔离的 Docker 容器，用于运行其智能体、存储文件和工具。
• 灵活的模型支持： 适用于任何兼容 LangChain 的提供商，包括 Claude、OpenAI 以及通过 Ollama 运行的本地模型。
• 基于文件的记忆： 使用简单的 Markdown 文件来存储智能体记忆和用户上下文，方便查看或编辑智能体所掌握的信息。
• MCP 集成： 支持 Claude 风格的 MCP 服务器，以便与 GitHub、Linear 和 Notion 等应用程序连接。
• 实时引导： 允许你在智能体正在工作时发送消息，智能体会将其纳入当前任务中。
• 外部访问： 暴露了符合 ACP 标准的 WebSocket API，允许外部编辑器和应用程序与你的智能体进行交互。