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 이상
• Ollama 설치: brew install ollama
• Node.js 20+ 설치: brew install node
• pnpm 전역 설치: npm install -g pnpm

Step 1: Ollama 설치 및 모델 가져오기

• Ollama 설치: brew install ollama
• Ollama 시작: ollama serve
• 별도의 터미널에서 AI 모델 가져오기: ollama pull qwen2.5

Step 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

Step 3: 개발 환경에서 앱 실행

• Ollama 시작: ollama serve
• 백엔드 시작: cd mane-ai-backend; pnpm start:dev
• 앱 실행: Xcode에서 ManeAI/ManePaw.xcodeproj를 열고 Run 버튼을 누르기

Importing Content

지식 기반에 파일이나 폴더를 추가하려면 가져오기를 클릭합니다. 콘텐츠 유형은 다음과 같이 처리됩니다:

• 코드: 패키지 매니페스트 파일(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 인터페이스를 포함합니다. 모든 데이터는 기기에 남아 프라이버시와 보안을 보장합니다.

사용 사례

• 개인 개발자 지식베이스: 코드, 문서 및 메모를 인덱싱하여 프로젝트에 대한 질문에 빠르게 답합니다.
• 프라이빗 연구 라이브러리: 노트, PDFs 및 미디어를 로컬에 보관하고 자연어로 질의합니다.
• 제작자용 멀티모달 지식 허브: 이미지와 오디오 전사를 인덱싱하여 시각적 및 음향 콘텐츠를 탐색합니다.
• macOS에서의 교육 및 튜터링: 강의와 코드 샘플을 위한 개인 지식 도우미를 만듭니다.
• 프라이빗 팀 지식 베이스: 민감한 데이터를 로컬에 저장하고 로컬 접근 제어를 통해 보안을 유지하고자 하는 개인이나 소규모 팀에 적합합니다.

자주 묻는 질문

Q: Mane AI는 무료이고 오픈 소스인가요? A: Mane AI는 MIT 라이선스 하에 오픈 소스이며 GitHub에서 다운로드하고 수정해 로컬에서 실행할 수 있습니다.

Q: 시스템 요구사항은 무엇인가요? A: macOS 14+ Sonoma 이상, Ollama, Node.js 20+ 및 macOS 앱 개발용 Xcode 프로젝트를 실행할 수 있는 능력이 필요합니다.

Q: 내 데이터는 어디에 저장되며 얼마나 개인가요? A: 모든 데이터는 Mac에 남아 있으며 클라우드나 텔레메트리는 없고, 애플리케이션은 완전한 로컬 작동을 위해 설계되었습니다.

Q: 시작하려면 어떻게 해야 하나요? A: 최신 릴리스를 다운로드하거나 저장소를 클론하고 의존성을 설치하고 Ollama를 구성하고 모델을 가져온 뒤 Xcode에서 ManePaw.xcodeproj를 열고 앱을 실행하세요.