SweetHive Agents Node

Lo SweetHive Agents Node è un'app desktop per macOS e Windows che esegue i tuoi agenti SweetHive sul tuo computer. Gli agenti rispondono con modelli AI eseguiti in locale - prompt e contenuti non lasciano mai la tua macchina durante l'inferenza - e l'app può anche collegare assistenti come Claude o ChatGPT ai tuoi contenuti SweetHive tramite MCP.

Usi OpenClaw? Continua a funzionare come runtime alternativo: legge gli stessi bundle di configurazione. L'Agents Node rende però tutto un'unica installazione guidata.

Installazione

Scarica l'app:
Aprila, leggi e accetta i termini.
Accedi con il tuo account SweetHive (stessa email e password dell'app web).

L'app si aggiorna automaticamente. Le build per macOS sono firmate e notarizzate da Apple, quindi si aprono senza avvisi.

Aggiornamenti

Quando esce una nuova versione, un banner in cima all'app dice che è disponibile una nuova versione, con un pulsante Aggiorna.
Da SweetHive web puoi aggiornare un nodo a distanza: My agents mostra un pulsante Aggiorna accanto a ogni nodo rimasto indietro, e la dashboard Il mio SweetHive mostra un banner. Il nodo scarica la nuova versione e si riavvia entro pochi minuti (dalla versione 0.2.15 in poi).
Le versioni più vecchie si aggiornano a mano: Impostazioni, Verifica aggiornamenti, poi Riavvia e aggiorna.

Aggiungere agenti di contesto

Un agente di contesto è una connessione limitata agli alveari e ai contesti che scegli - non può mai vedere più di quanto vedi tu. Puoi crearlo da entrambi i lati, e restano sincronizzati:

Dall'app - Context agents → New context agent: dagli un nome, scegli gli alveari, la capacità e la scadenza. Appare subito in SweetHive → I miei agenti.
Dal web SweetHive - My agents → Collega un agente: crea il token, scarica il bundle di configurazione e importalo nell'app (Context agents → Import config bundle).

Chatta con i tuoi agenti da My agents in SweetHive - le risposte sono generate sul tuo computer. Vedi Chatta con il tuo agente.

Modelli locali

Il runtime AI è integrato nell'app - non c'è nient'altro da installare. La scheda Modelli locali mostra un catalogo curato organizzato per tipo di macchina, con un consiglio per il tuo computer (famiglie attuali come Qwen, Gemma, Granite, Nemotron e Mistral): un clic installa un modello (con avanzamento in tempo reale), un clic lo disinstalla, e i modelli installati hanno un badge. I modelli che non sono più nel catalogo compaiono solo se sono già installati, in fondo, sotto Modelli precedenti su questo computer.

Se disinstalli un modello che uno dei tuoi agenti sta usando, l'app ti chiede cosa usare al suo posto (il modello predefinito o un altro modello installato), così nessun agente resta senza modello. In Impostazioni → Cartelle di archiviazione scegli dove salvare modelli, file temporanei e librerie degli strumenti.

Render worker (SweetReach)

Il nodo può anche eseguire render worker: plug-in che trasformano un brief di marketing in un video finito per SweetReach, l'app di marketing di SweetHive. Nella scheda Marketing, collega il nodo al backend di marketing con il segreto del tuo nodo, poi installa un worker:

HeyGen - avatar AI fotorealistici tramite l'API di HeyGen. Nessuna GPU necessaria; incolla la tua chiave HeyGen. Il nodo renderizza il video, lo scarica in locale, poi carica il file finito nello storage di SweetHive.
Avatar locale (GPU) - un avatar talking-head renderizzato interamente sulla tua GPU, offline, con una voce locale. Ideale su una workstation o un server.

I lavori video arrivano al nodo come lavori di SweetHive: li prende solo un nodo con un worker pronto (una chiave HeyGen o un worker GPU), che renderizza il video con il worker che hai scelto e consegna il file a SweetReach. Lo script viene scritto separatamente dall'agente collegato al contesto della campagna (che può essere in esecuzione su un nodo diverso), così ogni lavoro gira sulla macchina giusta. I nuovi worker appaiono nel catalogo senza aggiornare l'app.

Lavori: workflow e richieste delle app

Il nodo esegue i passaggi dei tuoi workflow e le richieste delle app di SweetHive con i suoi modelli locali: legge i documenti per SweetTimetable, renderizza i video per SweetReach, genera ed estrae testo. Prende il lavoro da solo appena SweetHive ha qualcosa per lui: non c'è niente da configurare app per app.

La sezione Lavori dell'app mostra, in parole semplici, cosa sta facendo il nodo adesso (con il suo avanzamento) e cosa ha fatto di recente, compreso il motivo per cui qualcosa non è riuscito (per esempio un modello non installato o un documento troppo lungo per il modello). La stessa lista è in SweetHive web in My agents, Lavori.

Lettura dei documenti (SweetTimetable)

Le scansioni e le foto caricate in SweetTimetable diventano lavori in My agents, Lavori, e le esegue il tuo nodo, quello condiviso dell'hive o l'Agents Server dell'organizzazione. In SweetTimetable vedi il risultato: le spese proposte da controllare in Carica documenti.

I PDF che contengono testo vero vengono letti direttamente sul server, senza bisogno di un nodo.
Una pagina con più scontrini viene letta a sezioni (ogni pedaggio autostradale è una spesa a sé): con un modello che vede le immagini come qwen2.5vl:7b ci vogliono circa due minuti su un Mac recente, e la trascrizione completa arriva dopo le spese proposte.
Se un lavoro resta in attesa, SweetTimetable e My agents ti dicono cosa fare: accendere il computer, aggiornare l'Agents Node o scegliere un modello che vede le immagini.
Controlla sempre le spese proposte prima di crearle.

Collegare Claude o ChatGPT

La scheda Collega app AI trasforma il nodo in un server MCP per il tuo assistente - ora con configurazione a un clic:

Collega Claude Code - trova la CLI claude e registra il nodo automaticamente; apri una nuova sessione e chiedi dei tuoi contenuti SweetHive.
Collega Claude Desktop - scrive la voce nella configurazione di Claude Desktop per te; riavvia Claude Desktop e gli strumenti sono pronti.
Opzioni per sviluppatori - lo snippet JSON e un endpoint MCP HTTP locale protetto da segreto per altri client.

SweetHive Desktop - chatta con il tuo computer

La scheda Chat include SweetHive Desktop: conversazioni con la macchina stessa, organizzate come una chat AI moderna (elenco di conversazioni con titolo, Nuova chat). Le risposte arrivano dal tuo modello locale predefinito e i dati restano sul computer; le conversazioni si sincronizzano con il tuo account, così puoi aprirle anche da SweetHive web (My agents → SweetHive Desktop) e parlare col tuo computer da remoto - risponde in pochi secondi quando l'app è in esecuzione.

Privacy e controllo

I token hanno un perimetro, scadono e sono revocabili in ogni momento da My agents.
I segreti sono cifrati con il portachiavi del sistema operativo.
L'inferenza dei modelli avviene interamente sulla tua macchina.