Mane AI

O que é Mane AI?

Mane AI é uma base de conhecimento de IA privada, executada no dispositivo, para macOS, que indexa documentos, código, imagens e áudio e permite chat em linguagem natural com seus dados. Funciona inteiramente no seu computador, sem tráfego de nuvem, sem telemetria e sem contas. O aplicativo é construído com SwiftUI para uma experiência rápida e nativa e é alimentado pela Ollama para modelos de linguagem locais. Mane AI oferece busca semântica e capacidades multimodais, para que você possa consultar não apenas texto, mas código, imagens e áudio.

Principais Características

• Base de conhecimento unificada: importe pastas e arquivos para construir sua base de conhecimento pessoal, com detecção automática de projetos de código e indexação inteligente.
• Chat alimentado por RAG: faça perguntas sobre seus documentos e obtenha respostas da IA com citações de fontes, recuperando primeiro o contexto relevante.
• Pesquisa Semântica: encontre arquivos por significado, não apenas por palavras-chave exatas, em documentos, código e descrições de imagens.
• Suporte Multimodal: indexe e interroge imagens (com legendas geradas por IA) e áudio (com transcrição).
• 100% Privado: sem telemetria, sem nuvem, sem contas. Seus dados permanecem no seu Mac.
• Desempenho Nativo: desenvolvido com SwiftUI para uma experiência rápida e responsiva com animações suaves alimentadas pelo Metal.
• Detecção de Projetos: detecta automaticamente projetos via um conjunto de arquivos manifest como package.json para Node/JS, Cargo.toml para Rust, pyproject.toml para Python, go.mod para Go, pom.xml para Java, pubspec.yaml para Flutter, manifest Swift, etc.
• Arquitetura Local: o aplicativo cliente em SwiftUI se comunica com um backend local, usando um armazenamento vetorial para busca semântica.

Como Usar Mane AI

Pré-requisitos e etapas de instalação são fornecidos para configurar um fluxo de IA local completo no seu Mac.

Pré-requisitos

• macOS 14+ Sonoma ou posterior
• Ollama instalado via brew install ollama
• Node.js 20+ via brew install node
• pnpm instalado globalmente via npm install -g pnpm

Passo 1: Instale Ollama e baixe o modelo

• Instale Ollama: brew install ollama
• Inicie Ollama: ollama serve
• Em um terminal separado, baixe o modelo de IA: ollama pull qwen2.5

Passo 2: Baixar Mane AI

• Baixe a versão mais recente na página Releases do repositório
• Ou compile a partir do código fonte: clone o repositório, instale as dependências do backend, abra o projeto Xcode

Comandos de exemplo:

• git clone https://github.com/ajagatobby/Mane-mac-app.git
• cd Mane-mac-app
• cd mane-ai-backend
• pnpm install
• Abrir no Xcode: open ../ManeAI/ManePaw.xcodeproj

Passo 3: Executar o app em um ambiente de desenvolvimento

• Inicie Ollama: ollama serve
• Inicie o backend: cd mane-ai-backend; pnpm start:dev
• Execute o app: Abrir ManeAI/ManePaw.xcodeproj no Xcode e pressionar Run

Importação de Conteúdo

Clique Import para adicionar arquivos ou pastas à sua base de conhecimento. Os tipos de conteúdo são processados da seguinte forma:

• Código: Detectado por arquivos de manifesto como package.json ou Cargo.toml e indexado com assinaturas de funções e classes.
• Texto: Arquivos de texto são divididos em fragmentos e incorporados para busca semântica.
• Imagens: legendas geradas por IA descrevem o conteúdo visual.
• Áudio: áudio é transcrito para texto pesquisável.

Tipos de Arquivos Suportados:

• Texto: .txt, .md, .json, .yaml, .xml, .html, .css, .csv
• Código: .swift, .ts, .js, .py, .rs, .go, .java, .rb, .php
• Imagens: .png, .jpg, .jpeg, .gif, .webp, .heic
• Áudio: .mp3, .wav, .m4a, .aiff, .flac, .ogg

Detecção de Projetos

Mane AI detecta automaticamente projetos por meio de um conjunto de arquivos manifest como package.json para Node/JS, Cargo.toml para Rust, pyproject.toml para Python, go.mod para Go, pom.xml para Java, pubspec.yaml para Flutter, manifest Swift, etc.

Exemplos de Chat

• Você pode fazer perguntas sobre o conteúdo indexado e obter respostas concisas da IA com citações relevantes.

Arquitetura

Mane AI é composto por um cliente SwiftUI e um backend NestJS local. O fluxo inclui um armazenamento vetorial local para busca semântica rápida e uma interface RAG para respostas contextuais. Todos os dados permanecem no dispositivo, garantindo privacidade e segurança.

Casos de Uso

• Base de conhecimento pessoal para desenvolvedores: indexe código, docs e notas para responder rapidamente a perguntas sobre seus projetos.
• Biblioteca de pesquisa privada: mantenha notas, PDFs e mídia localmente e interrogue com linguagem natural.
• Centro de conhecimento multimodal para criadores: indexe imagens e transcrições de áudio para explorar conteúdo visual e sonoro.
• Educação e tutoría em macOS: crie um assistente de conhecimento privado para cursos, palestras e exemplos de código.
• Base de conhecimento privada para equipes: adequada para indivíduos ou pequenas equipes que desejam manter dados confidenciais em sua própria máquina com controle de acesso local.

Perguntas Frequentes

Q: Mane AI é gratuito e open-source? A: Mane AI tem licença MIT e código aberto no GitHub. Você pode baixar, modificar e executar localmente.

Q: Quais são os requisitos do sistema? A: macOS 14+ Sonoma ou posterior, Ollama, Node.js 20+, e a capacidade de executar projetos Xcode para desenvolvimento de apps macOS.

Q: Onde meus dados residem e quão privado é o aplicativo? A: Todos os dados permanecem no seu Mac, não há nuvem nem telemetria; o aplicativo foi projetado para operação totalmente local.

Q: Como começar? A: Baixe a última versão ou clone o repositório, instale as dependências, configure o Ollama e puxe um modelo, em seguida abra ManePaw.xcodeproj no Xcode e execute o app.