LocalMind
Your AI, your data, your machine - Local First AI Platform
AI Self-Hosted Platform for Document Management, Semantic Search, Multi-Provider Chat LLM and Automation. Enterprise Java/Angular Stack with Hexagonal Architecture, RAG, MCP Integration (over 132 tools).
Key points to remember: * Federico Calò is a renowned expert in Angular and Spring Boot, known for his high-quality content on GitHub. * His Ollama project has gained significant attention due to its innovative approach. * The
- Data at Home: Never Exposed Without Explicit Configuration
- Zero Vendor Lock-in: Multi-Provider Gateway with Automatic Fallback
- 4 AI Providers
- Air-gapped operation with Ollama
- Architecture is hexagonal (Ports & Adapters) enforced at compile time
- Full-featured Radar: Tika → chunking → embedding → Qdrant → retrieval → SSE streaming
- MCP Integration: 132+ native tools on 9 classes
- Official SDKs: Java (Maven), JavaScript/TypeScript (npm), Python (pip)
- Batch Processing for Asynchronous Ingestion of Large Document Volumes
- 500+ unit tests (≥80% backend coverage), 67 end-to-end tests with Playwright
Strategic View and Objectives
LocalMind nasce per offrire una piattaforma AI local-first, modulare e self-hosted che mette al primo posto:
- Privacy by Design — i dati non lasciano mai la macchina locale salvo configurazione esplicita
- Zero Vendor Lock-in — gateway multi-provider con fallback automatico
- Costi controllati — Ollama gratuito locale, cloud pay-per-use, cost tracking integrato
- Funzionamento offline — piena operatività in ambienti air-gapped
- Integrazione enterprise Java — compatibile con AD/LDAP/SSO, Docker, Kubernetes, Actuator/Micrometer/JMX
- Trasparenza totale — ogni operazione tracciabile e misurabile
Octagonal Architecture (Ports & Adapters)
Le regole di dipendenza sono enforced a compile-time tramite la struttura multi-modulo Maven: il dominio non conosce né Spring né JPA.
localmind-backend/
├── localmind-domain/ Logica pura, zero dipendenze framework
│ ├── model/ Entità dominio
│ ├── port/in/ Use case
│ ├── port/out/ Interface adapter
│ └── service/ Implementazioni use case
├── localmind-infrastructure/ Adapter Spring (JPA, LLM, vector store)
├── localmind-api/ REST controllers /api/v1/*
├── localmind-batch/ Spring Batch jobs
└── localmind-app/ Boot entry, Flyway migrationsPipeline Rag
Ingestion → estrazione Tika → chunking → embedding (Ollama nomic-embed-text) → storage Qdrant → query semantica → context injection → LLM Gateway → risposta streaming SSE.
LLM Gateway - Strategy and Chain of Responsibility
- Routing: provider esplicito → default → primo disponibile nella chain
- Fallback chain: OLLAMA → OPENAI → ANTHROPIC → GOOGLE
- Retry: 3 tentativi, backoff esponenziale (1s → 2s → 4s), retryable su timeout/429/503
- Auto-config: provider con API key vuota disabilitati (
@ConditionalOnProperty) - EmbeddingModel: Ollama
@Primaryquando più provider attivi
MCP Integration — 132+ native tools
9 classi tool che coprono utility, code review, testing, DevOps, database, documentazione, project management Scrum, comunicazione, ops/infrastructure.
Functionality
- Chat AI Multi-Provider con SSE streaming, history, cost tracking
- Document Intelligence & RAG: PDF/DOCX/TXT/EML, chunking automatico
- AI Agents Specializzati: Tech, Business, Legal, Personal con tool calling
- MCP Integration: 132+ tool nativi su 9 classi
- Automazioni & Webhook: integrazione n8n per workflow no-code
- Batch Processing: scansione cartelle, ingestion asincrona
- Dashboard & Monitoring: health, costi, token usage, SLA
- Settings: CRUD provider LLM con chiavi cifrate
Full technology stack
| Level | Technology | Annotation |
|---|---|---|
| Backend Runtime | Java 17 LTS | — |
| Backend Framework | Spring Boot 3.4.2 | — |
| AI | Spring AI 1.0.0 | — |
| ORM | Spring Data JPA + Hibernate 6.x | — |
| Security | Spring Security 6.x | — |
| Batch | Spring Batch 5.x | — |
| Database | MySQL 8.0 | — |
| Vector store | Qdrant | embedding e ricerca semantica |
| OCR/Parsing | Apache Tika 2.9.2 | — |
| Migration | Flyway V1-V78 | — |
| Frontend | Angular 21.0.0 | Standalone, Signals |
| Testing E2E | Playwright (67 test) | — |
| Deploy | Docker + Compose + Nginx | — |
Main technologies
Project Gallery
Click on an image to enlarge it.
