Hivekeep
IT
Configura
Installazione

Metti in moto Hivekeep.

Un comando fa tutto. Una volta partito, Queenie configura il resto chiacchierando con te: nessun file di configurazione da modificare.

Consigliato · il modo più semplice

Incolla una riga. Fine.

Eseguila in un terminale sulla tua macchina Linux o macOS. Installa tutto al posto tuo.

curl -fsSL https://raw.githubusercontent.com/MarlBurroW/hivekeep/main/install.sh | bash

Quando finisce, apri nel browser il link che stampa. Al resto pensa Queenie.

Facoltativo

Vuoi una porta personalizzata, un dominio o Docker?

Salta questa parte se la riga qui sopra ti basta. Altrimenti rispondi a un paio di domande e generiamo il comando esatto per la tua configurazione.

1 · Come lo userai?

2 · Impostazioni

3 · Avvialo

Installashell
curl -fsSL https://raw.githubusercontent.com/MarlBurroW/hivekeep/main/install.sh | bash

La chiave di cifratura è gestita per te. L'installer la genera e la salva in automatico in $DATA_DIR/.encryption-key, così i tuoi segreti sopravvivono ai riavvii. Fai il backup di quel file insieme al database. (Se preferisci gestirla tu, fissa una ENCRYPTION_KEY con l'opzione avanzata qui sopra.)

Se l'installazione fallisce
  • port already in use / EADDRINUSE: la porta 3000 è occupata. Cambia il campo Porta qui sopra e riesegui.
  • Windows: l'installer è solo per Linux e macOS. Eseguilo dentro WSL2, o usa Docker Desktop.
  • Download o clone bloccato: assicurati che la macchina raggiunga github.com e bun.sh via HTTPS (un proxy potrebbe bloccarli).

Apri http://localhost:3000 nel browser. Queenie ti accompagna per il resto (account admin, il tuo primo provider IA, i tuoi primi agenti). Nessun file di configurazione da modificare.
Opzioni avanzate e alternative Requisiti, e Docker vs nativo vs da sorgenti
Prima di iniziare

Cosa serve al comando di installazione.

Quasi tutte le macchine hanno già tutto.

Puoi usare sudo
L'installer ne ha bisogno per installare i pacchetti di sistema mancanti (git, curl, unzip).
Circa 500 MB liberi su disco
Spazio per clonare e compilare. Con 1 GB o più si sta comodi.
Una macchina a 64 bit
x86_64 o ARM64. Il 32 bit (i Raspberry Pi più vecchi) non è supportato.
HTTPS in uscita
Scarica da github.com e bun.sh, quindi devono essere raggiungibili.
openssl presente
Serve a generare le chiavi. È incluso in quasi ogni Linux e macOS.

Sei su Windows? L'installer nativo non gira direttamente su Windows. Usa WSL2 (esegui il comando dentro la tua distro Linux) o Docker Desktop.

Confronto

Nativo, Docker o da sorgenti?

Tutti e tre eseguono esattamente la stessa app. Cambia solo il modo in cui vive sulla macchina.

Consigliato

Nativo (install.sh)

Scegli questo se vuoi solo che funzioni. Un comando, sulla tua macchina Linux o macOS.

  • Un solo comando, compila in locale, nessuna immagine da pubblicare o scaricare
  • Salva da solo la tua chiave di cifratura, i segreti persistono
  • Gira come servizio (systemd / launchd), aggiornamenti automatici con rollback
  • Gli agenti sono padroni della macchina: installano strumenti e dipendenze, accesso diretto all'hardware
  • Modifica il sistema host (per scelta)
  • Solo Linux e macOS (Windows via WSL2)
Container

Docker

Scegli questo se vivi già in Docker e vuoi un'appliance pulita e isolata.

  • Completamente isolato, zero impatto sull'host
  • Gira ovunque giri Docker, Windows compreso
  • L'immagine pubblicata non è ancora disponibile: per ora meglio il nativo
  • Strumenti e binari installati dagli agenti non sopravvivono a un riavvio
  • Devi rendere persistente il volume dati o perdi i tuoi segreti
Da sorgenti

Manuale

Scegli questo se vuoi leggere il codice, metterci mano o eseguirlo a modo tuo.

  • Controllo totale: cloni, compili ed esegui con Bun per conto tuo
  • Ideale per chi contribuisce e per lo sviluppo
  • Niente servizio, niente auto-update: li configuri tu
  • Bun, build, migrazioni e chiave di cifratura li gestisci a mano