Skip to content

README.it.md

Latest commit

 

History

History
207 lines (143 loc) · 8.05 KB

README.it.md

File metadata and controls

207 lines (143 loc) · 8.05 KB
Raw

Polywise Logo Polywise

Il sistema open source di contenuti agentici

X Discord License npm

English | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | 日本語 | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | Українська | বাংলা | Ελληνικά | Tiếng Việt

In modalità chiara si vede un sole illustrato, in modalità scura una luna con le stelle.

Cos'è Polywise

Polywise è un sistema open source di contenuti agentici. Puoi usarlo da riga di comando oppure dall'app desktop per parlare con i modelli, salvare conoscenza, recuperare contesto e trasformare i modi di lavorare ripetuti in agenti riutilizzabili.

🚀 Installazione

Polywise ha due punti di ingresso davvero pratici: la CLI e l'app desktop.

CLI

Installa la CLI globalmente:

npm install -g polywise

Avvia il servizio locale di Polywise:

polywise start
polywise start -d

polywise start mantiene il servizio in primo piano. polywise start -d termina subito e lascia il servizio attivo in background.

Poi apri la Web UI su http://localhost:3072/app/ .

Dalle impostazioni puoi attivare l'accesso con Auth. Una volta attivato e impostata una password, dovrai effettuare il login per accedere alla Web UI e anche l'API sarà protetta. È fondamentale se pensi di distribuire Polywise su un server per l'accesso remoto.

App desktop

Scarica la build desktop più recente da GitHub Releases.

Se vuoi esplorare sessioni, contenuti salvati, agenti e post senza stare sempre nel terminale, l'app desktop è il modo più semplice.

Primo avvio

Per il primo utilizzo, a Polywise serve soprattutto:

  • un provider di modelli disponibile
  • modelli di embedding e rerank se vuoi recuperare i contenuti salvati

Non è necessario configurare tutti i provider e tutte le integrazioni il primo giorno.

⬆️ Aggiornamento

CLI

polywise upgrade

App desktop

Installa l'ultima release da GitHub Releases.

⚡ Avvio rapido

Se vuoi arrivare al primo risultato utile nel modo più diretto:

  1. Apri Settings -> Model Provider e configura un provider che puoi davvero usare subito.
  2. Apri Settings -> Model Setting e verifica che il modello chat predefinito sia disponibile.
  3. Vai in Session e fai una domanda vera invece di mandare soltanto hello.
  4. Salva in Polywise una breve nota, un riassunto di pagina oppure una risposta.
  5. Cita di nuovo quell'elemento salvato nella chat per verificare che il recupero funzioni.

🧭 Utilizzo

Quando hai collegato un provider e impostato il modello predefinito, smetti di configurare e inizia davvero a usare il prodotto.

App desktop

L'app si capisce molto meglio se assegni a ogni area un compito concreto:

  • Session per fare domande vere, pianificare il lavoro e restare nel contesto del tuo workspace
  • Linkcase per recuperare contenuti dal web e portarli nel sistema
  • Agent per trasformare stili di istruzioni ripetuti in collaboratori riutilizzabili
  • Posts per salvare conoscenza che merita di vivere più a lungo di una risposta in chat

Ci sono due scorciatoie che conviene imparare presto:

  • @ porta file, agenti e altro contesto dentro una sessione
  • / porta strumenti e skill nel flusso di lavoro

CLI

La CLI è un wrapper leggero sopra l'API backend. Per impostazione predefinita parla con http://localhost:3072; se il tuo server si trova altrove, imposta POLYWISE_SERVER_URL.

Invece di imparare i comandi a memoria, parti dalla guida:

polywise -h
polywise session -h
polywise session create -h

Usa input_schema quando ti serve la struttura esatta di input di un comando:

polywise input_schema session.create

Comandi comuni:

polywise start
polywise start -d
polywise version
polywise session create --title "Daily Review"
polywise search fullTextSearch --query "vector database"
polywise save --for user --content "Key takeaway..."

Quando i payload diventano più complessi, puoi passare direttamente JSON:

polywise search fullTextSearch --json '{"query":"agent memory","for_types":["wiki","memory"],"enable_recall":true}'

📚 Documentazione

🎬 Intro Video

Open the intro video file

💭 Motivazione

Polywise nasce dalla convinzione che un'IA davvero intelligente abbia bisogno di una memoria davvero intelligente. Non si tratta solo di archiviare cose, ma di costruire un sistema capace di creare connessioni in modo organico, rafforzarsi con l'uso, dimenticare in modo strategico ed evolvere nel tempo.

📄 Riferimenti

Questo progetto è stato ispirato dai seguenti articoli di ricerca:

🙏 Ringraziamenti

Polywise si appoggia a questi eccellenti progetti open source:

Libraries & Tools

  • 🐘 Sqlite - Il database embedded ad alte prestazioni più distribuito al mondo
  • 🏹 sqlite-vec - Aggiunge la ricerca vettoriale a Sqlite
  • ⚛️ React - Libreria UI frontend
  • 🖥️ Electron - Framework per applicazioni desktop
  • 🔗 tRPC - API type-safe end-to-end
  • 📦 MobX - Gestione dello stato semplice e scalabile
  • 🎨 Tailwind CSS - Framework CSS utility-first
  • 🚀 Hono - Framework web ultrarapido
  • 🛠️ Rsbuild - Strumento di build di nuova generazione basato su Rspack
  • 📚 Rslib - Strumento per build di librerie basato su Rsbuild
  • 🤖 AI SDK - Toolkit unificato per creare applicazioni basate sull'IA
  • 🤗 node-llama-cpp – Binding Node.js per llama-cpp pensati per collegarsi a modelli locali

📜 Licenza

MIT – Vedi LICENSE per i dettagli.