Mane AI

Mane AI 是什么？

Mane AI 是一个私有的、在本地设备上运行的 macOS AI 知识库，能够对文档、代码、图像和音频进行索引，并实现与数据的自然语言对话。它完全在您的机器上运行，没有云流量、没有遥测，也没有账户。该应用使用 SwiftUI 构建，提供快速、原生的体验，并由 Ollama 提供本地大型语言模型。Mane AI 提供语义搜索和多模态能力，因此您不仅可以查询文本，还可以查询代码、图像和音频。

主要特征

• 统一知识库：导入文件夹和文件以构建您的个人知识库，能够自动检测代码项目并进行智能索引。
• 基于 RAG 的聊天：就您的文档提问，获得带有来源引用的 AI 回应，优先检索相关上下文。
• 语义搜索：通过含义来查找文件，而不仅仅是关键词，在文档、代码和图像描述中进行检索。
• 多模态支持：对图像（带 AI 字幕）和音频（带转写）进行索引和查询。
• 100% 私有：没有遥测、没有云端、没有账户。您的数据保留在您的 Mac 上。
• 原生性能：使用 SwiftUI 构建，提供快速、响应迅速的体验，动画流畅，由 Metal 提供动力。
• 项目检测：通过诸如 package.json、Cargo.toml 等清单文件自动检测软件项目。
• 本地架构：SwiftUI 客户端与本地后端通讯，使用向量存储进行语义检索。

如何使用 Mane AI

先决条件与安装步骤为在您的 Mac 上设定一个完整的本地 AI 工作流程提供了必要信息。

先决条件

• macOS 14+ Sonoma 或更高版本
• 通过 brew install ollama 安装 Ollama
• 通过 brew install node 安装 Node.js 20+
• 通过 npm install -g pnpm 全局安装 pnpm

步骤 1：安装 Ollama 并拉取模型

• 安装 Ollama：brew install ollama
• 启动 Ollama：ollama serve
• 在另一个终端中拉取 AI 模型：ollama pull qwen2.5

步骤 2：下载 Mane AI

• 从仓库的 Releases 页面下载最新版本
• 或从源码构建：克隆仓库，安装后端依赖，打开 Xcode 项目

命令示例：

• git clone https://github.com/ajagatobby/Mane-mac-app.git
• cd Mane-mac-app
• cd mane-ai-backend
• pnpm install
• 在 Xcode 中打开：open ../ManeAI/ManePaw.xcodeproj

步骤 3：在开发环境中运行应用

• 启动 Ollama：ollama serve
• 启动后端：cd mane-ai-backend; pnpm start:dev
• 运行应用：在 Xcode 中打开 ManeAI/ManePaw.xcodeproj 并按 Run

导入内容

单击 导入 将文件或文件夹添加到您的知识库。内容类型的处理如下：

• 代码：通过 package.json、Cargo.toml 等清单文件进行检测，并按函数和类签名进行索引。
• 文本：文本文件将被分块并嵌入向量以用于语义搜索。
• 图像：AI 生成的字幕描述可视内容。
• 音频：音频将转写为可搜索的文本。

支持的文件类型：

• 文本：.txt、.md、.json、.yaml、.xml、.html、.css、.csv
• 代码：.swift、.ts、.js、.py、.rs、.go、.java、.rb、.php
• 图像：.png、.jpg、.jpeg、.gif、.webp、.heic
• 音频：.mp3、.wav、.m4a、.aiff、.flac、.ogg

项目检测：

• Mane AI 会通过一组清单文件（例如 Node/JS 的 package.json、Rust 的 Cargo.toml、Python 的 pyproject.toml、Go 的 go.mod、Java 的 pom.xml、Flutter 的 pubspec.yaml、Swift 清单等）自动检测项目。

聊天示例：

• 您可以就已索引的内容提问，并获得带有相关引用的简明 AI 回应。

架构

Mane AI 由一个 SwiftUI 客户端和一个本地 NestJS 后端组成。流程包含用于快速语义搜索的本地向量存储和用于上下文感知响应的 RAG 界面。所有数据均保留在设备上，确保隐私和安全。

使用场景

• 个人开发者知识库：对代码、文档和笔记进行索引，以快速回答关于您项目的问题。
• 私人研究库：将笔记、PDF 与媒体本地保存，并用自然语言查询。
• 创作者的多模态知识中心：对图像和音频转录进行索引，探索视觉和音频内容。
• macOS 上的教育与辅导：为课程、讲座和代码示例构建私有知识助手。
• 私有团队知识库：适用于希望将敏感数据保留在本机并具备本地访问控制的个人或小型团队。

常见问题

Q：Mane AI 免费且开源吗？ A：Mane AI 采用 MIT 授权并在 GitHub 开源。您可以下载、修改并在本地运行。

Q：系统要求是什么？ A：macOS 14+ Sonoma 或更高版本、Ollama、Node.js 20+，以及能够运行 Xcode 项目以进行 macOS 应用开发。

Q：我的数据存放在哪里，隐私性如何？ A：所有数据都保留在您的 Mac 上，没有云端或遥测；应用设计为完全本地运行。

Q：如何开始？ A：下载最新版本或克隆仓库，安装依赖项，配置 Ollama 并拉取模型，然后在 Xcode 中打开 ManePaw.xcodeproj 并运行应用。