Mane AI

Cos'è Mane AI?

Mane AI è una base di conoscenza AI privata sul dispositivo per macOS che indicizza documenti, codice, immagini e audio e consente una chat in linguaggio naturale con i tuoi dati. Funziona interamente sul tuo computer, senza traffico verso il cloud, senza telemetria e senza account. L'app è costruita con SwiftUI per un'esperienza veloce e nativa ed è alimentata da Ollama per modelli di linguaggio di grandi dimensioni locali. Mane AI offre ricerca semantica e capacità multimodali, così puoi interrogare non solo testo ma anche codice, immagini e audio.

Caratteristiche principali

• Base di conoscenza unificata: importa cartelle e file per costruire la tua base di conoscenza personale, con rilevamento automatico di progetti di codice e indicizzazione intelligente.
• Chat alimentata da RAG: poni domande sui tuoi documenti e ottieni risposte AI con citazioni delle fonti, recuperando prima il contesto rilevante.
• Ricerca semantica: trova file per significato, non solo per parole chiave esatte, tra documenti, codice e descrizioni delle immagini.
• Supporto multimodale: indicizza e interroga immagini (con didascalie generate dall'IA) e audio (con trascrizione).
• 100% Privato: nessuna telemetria, nessun cloud, nessun account. I tuoi dati rimangono sul tuo Mac.
• Prestazioni native: sviluppato con SwiftUI per un'esperienza rapida e reattiva con animazioni fluide supportate da Metal.
• Rilevamento di progetti: rileva automaticamente i progetti tramite una serie di file manifest come package.json per Node/JS, Cargo.toml per Rust, pyproject.toml per Python, go.mod per Go, pom.xml per Java, pubspec.yaml per Flutter, manifest Swift, ecc.
• Architettura locale: l'app client in SwiftUI comunica con un backend locale, con un archivio vettoriale usato per la ricerca semantica.

Come usare Mane AI

Prerequisiti e passaggi di installazione sono forniti per impostare un flusso di lavoro AI completamente locale sul tuo Mac.

Prerequisiti

• macOS 14+ Sonoma o versioni successive
• Ollama installato tramite brew install ollama
• Node.js 20+ tramite brew install node
• pnpm installato globalmente tramite npm install -g pnpm

Step 1: Installa Ollama e scarica il modello

• Installa Ollama: brew install ollama
• Avvia Ollama: ollama serve
• In un terminale separato, scarica il modello AI: ollama pull qwen2.5

Step 2: Scarica Mane AI

• Scarica l'ultima versione dalla pagina Releases del repository
• Oppure costruisci da sorgente: clona il repository, installa le dipendenze del backend, apri il progetto Xcode

Comandi di esempio:

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

Step 3: Esegui l'app in un ambiente di sviluppo

• Avvia Ollama: ollama serve
• Avvia backend: cd mane-ai-backend; pnpm start:dev
• Esegui l'app: Apri ManeAI/ManePaw.xcodeproj in Xcode e premi Esegui

Importazione dei contenuti

Clicca Import per aggiungere file o cartelle alla tua knowledge base. I tipi di contenuto sono elaborati come segue:

• Codice: rilevato da file manifest come package.json o Cargo.toml e indicizzato con firme di funzioni e classi.
• Testo: i file di testo sono suddivisi in frammenti e inseriti per la ricerca semantica.
• Immagini: didascalie generate dall'IA descrivono il contenuto visivo.
• Audio: l'audio viene trascritto in testo ricercabile.

Tipi di file supportati

• Testo: .txt, .md, .json, .yaml, .xml, .html, .css, .csv
• Codice: .swift, .ts, .js, .py, .rs, .go, .java, .rb, .php
• Immagini: .png, .jpg, .jpeg, .gif, .webp, .heic
• Audio: .mp3, .wav, .m4a, .aiff, .flac, .ogg

Detezione di Progetti

Mane AI rileva automaticamente i progetti tramite un insieme di file manifest come package.json per Node/JS, Cargo.toml per Rust, pyproject.toml per Python, go.mod per Go, pom.xml per Java, pubspec.yaml per Flutter, manifest Swift, et cetera.

Esempi di chat:

• Puoi porre domande sui contenuti indicizzati e ottenere risposte concise dall'IA con citazioni pertinenti.

Architettura

Mane AI è composto da un client SwiftUI e da un backend NestJS locale. Il flusso include un archivio vettoriale locale per una rapida ricerca semantica e un'interfaccia RAG per risposte contestualizzate. Tutti i dati rimangono sul dispositivo, garantendo privacy e sicurezza.

Casi d'uso

• Base di conoscenza personale per sviluppatori: indicizza codice, documenti e note per rispondere rapidamente alle domande sui tuoi progetti.
• Biblioteca di ricerca privata: mantieni note, PDF e media localmente e interroga con linguaggio naturale.
• Hub di conoscenza multimodale per creatori: indicizza immagini e trascrizioni di audio per esplorare contenuti visivi e audio.
• Educazione e tutoraggio su macOS: crea un assistente di conoscenza privata per corsi, lezioni e esempi di codice.
• Base di conoscenza privata per team: adatta a individui o piccoli team che vogliono mantenere dati sensibili sul proprio computer con controllo di accesso locale.

Domande frequenti

Q: Mane AI è gratuito e con licenza open source? A: Mane AI è rilasciato con licenza MIT e open source su GitHub. Puoi scaricarlo, modificarlo ed eseguirlo localmente.

Q: Quali sono i requisiti di sistema? A: macOS 14+ Sonoma o versioni successive, Ollama, Node.js 20+, e la possibilità di eseguire progetti Xcode per lo sviluppo di app macOS.

Q: Dove risiedono i miei dati e quanto è privata la tua app? A: Tutti i dati rimangono sul tuo Mac, non c'è cloud né telemetria; l'app è progettata per un funzionamento completamente locale.

Q: Come si inizia? A: Scarica l'ultima versione o clona il repository, installa le dipendenze, configura Ollama e scarica un modello, poi apri ManePaw.xcodeproj in Xcode ed esegui l'app.