Mane AI

¿Qué es Mane AI?

Mane AI es una base de conocimiento de IA privada y local para macOS que indexa documentos, código, imágenes y audio y permite conversar con tus datos en lenguaje natural. Se ejecuta completamente en tu máquina, sin tráfico a la nube, sin telemetría y sin cuentas. La app está construida con SwiftUI para una experiencia rápida y nativa y está alimentada por Ollama para modelos de lenguaje grandes locales. Mane AI ofrece búsqueda semántica y capacidades multimodales, por lo que puedes consultar no solo texto sino también código, imágenes y audio.

Características clave

• Base de conocimiento unificada: importa carpetas y archivos para construir tu base de conocimiento personal, con detección automática de proyectos de código y una indexación inteligente.
• Chat impulsado por RAG: haz preguntas sobre tus documentos y obtén respuestas de IA con citas de fuentes, recuperando primero el contexto relevante.
• Búsqueda semántica: encuentra archivos por significado, no solo por palabras clave exactas, en documentos, código y descripciones de imágenes.
• Soporte multimodal: indexa y consulta imágenes (con subtítulos generados por IA) y audio (con transcripción).
• 100% privado: sin telemetría, sin nube, sin cuentas. Tus datos permanecen en tu Mac.
• Rendimiento nativo: construido con SwiftUI para una experiencia rápida y sensible con animaciones suaves impulsadas por Metal.
• Detección de proyectos: detecta automáticamente proyectos de software a través de archivos de manifiesto como package.json o Cargo.toml.
• Arquitectura local: la app cliente en SwiftUI se comunica con un backend local, con una tienda de vectores utilizada para la búsqueda semántica.

Cómo usar Mane AI

Las requisitos previos e pasos de instalación se proporcionan para configurar un flujo de trabajo de IA local completo en tu Mac.

Requisitos previos

• macOS 14+ Sonoma o posterior
• Ollama instalado: brew install ollama
• Node.js 20+ vía brew: brew install node
• pnpm instalado globalmente: npm install -g pnpm

Paso 1: Instalar Ollama y obtener el modelo

• Instalar Ollama: brew install ollama
• Iniciar Ollama: ollama serve
• En una terminal separada, obtener el modelo de IA: ollama pull qwen2.5

Paso 2: Descargar Mane AI

• Descargar la última versión desde la página de Releases del repositorio
• O compilar desde el código fuente: clonar el repositorio, instalar las dependencias del backend y abrir el proyecto Xcode

Ejemplos de comandos:

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

Paso 3: Ejecutar la app en un entorno de desarrollo

• Iniciar Ollama: ollama serve
• Iniciar el backend: cd mane-ai-backend; pnpm start:dev
• Ejecutar la app: Abrir ManeAI/ManePaw.xcodeproj en Xcode y pulsar Run

Importación de contenidos

Haz clic en Importar para añadir archivos o carpetas a tu base de conocimientos. Los tipos de contenido se procesan como sigue:

• Código: Detectado por archivos de manifiesto como package.json o Cargo.toml y indexado con firmas de funciones y clases.
• Texto: Los archivos texto se dividen en fragmentos y se embeben para búsqueda semántica.
• Imágenes: Descripciones generadas por IA describen el contenido visual.
• Audio: Se transcribe el audio a texto buscable.

Tipos de archivos compatibles:

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

Detección de proyectos:

• Mane AI detecta automáticamente proyectos mediante un conjunto de archivos de manifiesto 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, manifiesto de Swift, etc.

Ejemplos de chat:

• Puedes hacer preguntas sobre tu contenido indexado y obtener respuestas de IA con citas relevantes.

Arquitectura

Mane AI se compone de un cliente SwiftUI y un backend NestJS local. El flujo incluye un vector store local para búsquedas semánticas rápidas y una interfaz RAG para respuestas contextualizadas. Todos los datos permanecen en el dispositivo, garantizando la privacidad y la seguridad.

Casos de uso

• Base de conocimientos personal para desarrolladores: Indexa código, documentación y notas para responder rápidamente a preguntas sobre tus proyectos.
• Biblioteca de investigación privada: Mantén tus notas, PDFs y medios localmente y pregúntalos con lenguaje natural.
• Centro de conocimiento multimodal para creadores: Indexa imágenes y transcripciones de audio para explorar contenido visual y sonoro.
• Educación y tutoría en macOS: Crea un asistente de conocimiento privado para cursos, conferencias y ejemplos de código.
• Base de conocimientos privada para equipos: Adecuado para individuos o pequeños equipos que deseen mantener datos sensibles en su propia máquina con control de acceso local.

Preguntas frecuentes

P: ¿Mane AI es gratuito y de código abierto? R: Mane AI tiene licencia MIT y es de código abierto en GitHub. Puedes descargar, modificar y ejecutar localmente.

P: ¿Cuáles son los requisitos del sistema? R: macOS 14+ Sonoma o posterior, Ollama, Node.js 20+ y la capacidad de ejecutar proyectos Xcode para desarrollo de apps macOS.

P: ¿Dónde residen mis datos y qué tan privado es? R: Todos los datos permanecen en tu Mac, no hay nube ni telemetría; la app está diseñada para operación completamente local.

P: ¿Cómo puedo empezar? R: Descarga la última versión o clona el repositorio, instala dependencias, configura Ollama y descarga un modelo, luego abre ManePaw.xcodeproj en Xcode y ejecuta la app.