Installazione

Kore Memory è distribuito come pacchetto Python su PyPI. Richiede Python 3.11 o successivo.

Installazione rapida

pip install kore-memory

Questo installa la libreria base con ricerca full-text FTS5. Non ha dipendenze pesanti e funziona immediatamente.

Extra di installazione

Kore Memory utilizza extra opzionali per mantenere leggera l'installazione base. Installa solo ciò di cui hai bisogno:

Solo il core (ricerca FTS5)

pip install kore-memory

Include:

• Server REST API completo
• Ricerca full-text FTS5
• Punteggio di importanza automatico
• Motore di decay di Ebbinghaus
• Tag, relazioni, timeline
• Export/import, archivio
• Dashboard web

informazioni

La ricerca FTS5 è basata su parole chiave e funziona bene per corrispondenze esatte. Per ricerche fuzzy, cross-language e per similarità semantica, installa l'extra semantic.

Ricerca semantica

pip install kore-memory[semantic]

Aggiunge:

• Embedding locali con sentence-transformer (paraphrase-multilingual-MiniLM-L12-v2)
• Ricerca per similarità coseno in oltre 50 lingue
• Compressione della memoria (unisce ricordi simili)
• Nessuna API key o chiamata cloud necessaria

suggerimento

Il modello di embedding predefinito pesa circa 120 MB e viene scaricato automaticamente al primo utilizzo. Funziona su CPU -- nessuna GPU necessaria.

Server MCP

pip install kore-memory[semantic,mcp]

Aggiunge:

• Server MCP (Model Context Protocol) con 14 tool
• Compatibile con Claude Desktop, Cursor, Claude Code e altri client MCP
• Avvio tramite il comando kore-mcp

Tutti gli extra

pip install kore-memory[semantic,mcp]

Questa è l'installazione consigliata per la maggior parte degli utenti. Fornisce il set completo di funzionalità.

Installazione da sorgente

Clona il repository e installa in modalità sviluppo:

git clone https://github.com/auriti-web-design/kore-memory.git
cd kore-memory
pip install -e ".[semantic,mcp]"

Utile per contribuire al progetto o per eseguire le ultime modifiche non ancora rilasciate.

Dipendenze di sviluppo

Se intendi contribuire, installa anche gli extra di sviluppo:

pip install -e ".[semantic,mcp,dev]"

Questo aggiunge strumenti di testing (pytest, coverage), linting (ruff, mypy) e utilità per la documentazione.

Verifica dell'installazione

Dopo l'installazione, verifica che tutto funzioni:

# Controlla che la CLI sia disponibile
kore --help

# Avvia il server
kore

# In un altro terminale, verifica lo stato
curl http://localhost:8765/health

Dovresti vedere un output simile a:

{
  "status": "healthy",
  "version": "1.0.0",
  "capabilities": {
    "semantic_search": true,
    "fts5": true,
    "mcp": true
  }
}

Client JavaScript / TypeScript

Se hai bisogno di connetterti a un server Kore Memory in esecuzione da un ambiente Node.js o browser:

npm install kore-memory-client

Caratteristiche:

• Zero dipendenze
• Supporto ESM + CJS
• Tipi TypeScript completi
• 17 metodi asincroni
• ~6 KB minificato
• Node 18+

import { KoreClient } from 'kore-memory-client';

const kore = new KoreClient({
  baseUrl: 'http://localhost:8765',
  agentId: 'my-agent'
});

await kore.save({ content: 'Hello from TypeScript', category: 'general' });
const results = await kore.search({ q: 'hello', limit: 5 });

Requisiti di sistema

Requisito	Minimo	Consigliato
Python	3.11	3.12+
RAM	256 MB	512 MB+ (con semantic)
Disco	50 MB	200 MB+ (download del modello)
SO	Linux, macOS, Windows	Qualsiasi
GPU	Non necessaria	Non necessaria
Rete	Non necessaria	Non necessaria

warning

SQLite deve essere compilato con supporto FTS5. Questo è incluso di default nel SQLite distribuito con Python sulla maggior parte delle piattaforme. Se ricevi un errore FTS5, ricompila Python con una versione più recente di SQLite.

Aggiornamento

pip install --upgrade kore-memory

Kore Memory gestisce automaticamente le migrazioni del database. I ricordi esistenti vengono preservati durante gli aggiornamenti.

Disinstallazione

pip uninstall kore-memory

Il database dei ricordi (predefinito: data/memory.db) non viene rimosso. Eliminalo manualmente se desideri ripartire da zero.