Ask Vit
MotusOSS
Orbis
ContactAsk VitGet Started
ENIT

Installazione · self-hosted

Un comando, ed è in esecuzione sulla tua macchina.

Vitruvyan si installa su qualsiasi host con Docker. L'installer fornisce il kernel, il bus cognitivo, la memoria semantica e l'archivio, mette la CLI vit nel tuo PATH, e ti restituisce uno stack già sano.

È la tua macchina, e resta la tua macchina. Ogni valore scritto dall'installer è locale. Non c'è nessun account da creare e niente che telefoni a casa.

bash — get.vitruvyan.com
$ curl -fsSL https://get.vitruvyan.com | bash

  Checking prerequisites…
  ✓ Docker 24.0.7 · Compose v5.1.4
  ✓ 32 GB RAM · 1 TB disk · Ubuntu 24.04 LTS
—
  Pulling kernel, bus, memory, archive…
  Writing /etc/vitruvyan — environment, secrets, compose
  ✓ 7 packages healthy
  ✓ vit installed at /usr/local/bin/vit

$ vit status

    Installed:  1.39.0
    Available:  1.39.0
    ✓ Up to date

Una sessione reale su Vitruvyan Core 1.39.0. Due cose sono normalizzate, ed entrambe appartengono alla macchina più che al prodotto: il percorso del repository, e il segno di spunta — la CLI stampa un'emoji, e questo foglio ha una palette misurata.

  • Tu esegui

    Una riga. L'installer controlla la macchina, scarica le immagini, scrive la configurazione e avvia lo stack.

  • Richiede

    Minuti su una macchina pulita, per lo più spesi a scaricare le immagini. Lo script attende che ogni servizio segnali di essere sano prima di restituire il controllo.

  • Tu ottieni

    Il kernel, il bus cognitivo, la memoria semantica, l'archivio, e la CLI vit nel tuo PATH.

  • Invia

    Niente. Configurazione, segreti e dati vengono scritti sul tuo disco; nessuna chiamata di licenza, nessuna telemetria, nessun account.

Cosa serve

Una dipendenza, e ce l'hai già.

Non c'è nessun runtime da installare prima, nessun database da mettere in piedi, nessun servizio gestito a cui iscriversi. Un host con Docker e un po' di spazio per lavorare è l'intera lista.

  • Docker

    24+

    Con Compose. L'unica dipendenza indispensabile.

  • RAM

    16 GB

    32 GB per il profilo completo con i motori.

  • Disco

    500 GB

    1 TB se intendi conservare le prove su larga scala.

  • OS

    Ubuntu 24.04 LTS

    Il sistema su cui viene testato. Funziona su qualsiasi host Docker.

Le macchine più piccole non sono escluse. I numeri qui sopra si riferiscono al profilo completo con tutti i motori attivi. Il profilo minimo è il solo kernel, a circa due gigabyte, e i pacchetti si installano uno alla volta in seguito — a questo servono i profili più avanti in questa pagina.

Un comando

Prendi la versione che hai chiesto, e nessun'altra.

Esegui uno di questi su una macchina pulita o su un server esistente. Il primo segue il canale stabile; il secondo fissa una release, ed è quello da usare se l'installazione deve essere riproducibile.

  • Canale stabile

    $ curl -fsSL https://get.vitruvyan.com | bash

    La release corrente. Quello che vuoi su una macchina che intendi mantenere aggiornata.

  • Versione fissata

    $ curl -fsSL https://get.vitruvyan.com/v1.16 | bash

    Una versione con nome. Stessa macchina, stessi byte, anche il mese prossimo.

Leggilo prima di eseguirlo. Instradare uno script in una shell è una decisione, e dovrebbe essere una decisione presa con lo script davanti agli occhi: curl -fsSL https://get.vitruvyan.com | less. Tutto quello che fa è nella sezione qui sotto, e non fa nient'altro.

Cosa fa l'installer

Cinque fasi, e fallisce prima di cambiare qualsiasi cosa.

  1. /01

    Controllo dell'ambiente

    Versione di Docker, Compose, RAM disponibile, disco, e ogni porta dei datastore che intende occupare. Fallisce prima di cambiare qualsiasi cosa, e indica quale controllo è fallito.

  2. /02

    Scarica le immagini del kernel

    I container principali: il bus cognitivo su Redis Streams, la memoria semantica su Qdrant, l'archivio su PostgreSQL, e il kernel che li orchestra.

  3. /03

    Scrive la configurazione

    Una directory di configurazione con i file d'ambiente, i segreti generati e i manifest Compose. Ogni valore è locale alla macchina — niente viene scaricato da noi e niente viene rimandato indietro.

  4. /04

    Avvia i servizi

    Compose avvia lo stack e vengono eseguiti gli health check. L'installer non restituisce il controllo finché ogni servizio non segnala di essere sano, quindi un prompt che ritorna significa un sistema attivo.

  5. /05

    Installa la CLI

    `vit` finisce nel tuo PATH con il proprio completamento per la shell registrato. Tutto quello che viene dopo — pacchetti, aggiornamenti, rollback — passa da lì.

La CLI vit

Tutto quello che viene dopo l'installazione è un comando.

Il wrapper non richiede un'installazione propria: risolve da sé le proprie dipendenze Python, registra il proprio completamento per la shell, e viene eseguito. Qui accanto trovi una sessione reale — il controllo dei prerequisiti, lo stato della versione, e l'elenco completo dei pacchetti.

Pacchetti, non un tarball. Ogni servizio e verticale porta con sé una versione, un intervallo di compatibilità e le proprie dipendenze. Installarne uno porta con sé ciò che gli serve; rimuoverlo lo toglie di nuovo; un aggiornamento che fallisce la validazione torna allo snapshot preso in precedenza.

Catturata da Vitruvyan Core 1.39.0. Solo il percorso del repository e il glifo di spunta sono normalizzati.

vit — vitruvyan core 1.39.0
$ vit setup --check

  Checking prerequisites...

  ✓ Git repo: /opt/vitruvyan-core
  ✓ Python: 3.12.3
  ✓ Docker: daemon running
  ✓ Docker Compose: v5.1.4
  ✓ redis: reachable on port 6389
  ✓ postgres: reachable on port 5442
  ✓ qdrant_rest: reachable on port 6343
  ✓ qdrant_grpc: reachable on port 6344

  ✓ All required prerequisites met.

$ vit status

—
    Vitruvyan Core — Update Status
—

    Installed:  1.39.0
    Available:  1.39.0

    ✓ Up to date

    Notification settings:
      Status: Enabled
      Channels: desktop, log
      Check interval: 24h

$ vit list --all

  Name                       Version       Type     Tier     Status
—
  order-babel-gardens        1.15.0        order    core     stable
  service-graph              1.15.0        service  core     stable
  service-neural-engine      2.1.0         service  package  stable
  service-mcp                2.0.0-beta.1  service  package  beta
  service-edge-oculus-prime  1.0.0         service  package  stable
  service-horizon-engine     1.0.0         service  package  experimental
  service-veritas-engine     1.0.0         service  package  experimental

  Total: 7 packages

  • Ciclo di vita del core

    vit update
    Controlla la disponibilità di aggiornamenti del Core. Sola lettura.
    vit plan
    Mostra il piano di aggiornamento — modifiche, rischi, test, downtime — senza applicarlo.
    vit upgrade
    Applica l'aggiornamento, con validazione di compatibilità e rollback automatico in caso di errore.
    vit rollback
    Ripristina l'ultimo snapshot dalla cronologia degli aggiornamenti.
    vit status
    Versione corrente, versione disponibile, stato delle notifiche.
    vit channel
    Passa dal canale di release stabile a quello beta, e viceversa.
    vit release
    Valida i metadati della release prima che la CI la pubblichi.

  • Pacchetti

    vit install
    Installa un pacchetto e tutto ciò che richiede.
    vit remove
    Rimuove un pacchetto, e con --purge anche i suoi dati e volumi.
    vit list
    I pacchetti installati, oppure tutti quelli disponibili con --all.
    vit search
    Cerca per nome o descrizione, localmente o sul registro remoto.
    vit info
    Manifest completo: intervallo di compatibilità, dipendenze, porte, endpoint di health, proprietario.

  • Bootstrap

    vit setup
    La procedura guidata del primo avvio: prerequisiti, porte, provider LLM, profilo, ambiente, container.
    vit completion
    Installa o rimuove il completamento bash, per singolo utente o a livello di sistema.

Cinque profili, e puoi cambiare idea più avanti.

vit setup chiede quale di questi vuoi, scrive l'ambiente e avvia i container. Passa --profile per saltare del tutto le domande. Niente di tutto questo è un livello di licenza — è quanto dello stack parte al primo avvio.

  • Minimo

    ~2 GB
    Il kernel soltanto — motore a grafo e gli ordini sacri.

  • Standard

    ~4 GB
    Il kernel più il Neural Engine, per l'analisi dei pattern.

  • Completo

    ~8 GB
    Ogni pacchetto incluse le beta: MCP e l'Horizon Engine.

  • Enterprise

    ~12 GB
    Lo stack completo più le console di intelligence — Insight, Truth, Decision.

  • Personalizzato

    variabile
    Scegli tu i pacchetti, uno alla volta.

Dopo l'installazione

Il kernel è attivo. Quattro comandi per vederlo.

  • $ vit setup --check

    Riesegue il controllo dei prerequisiti: Docker, Compose, e ogni porta dei datastore.

  • $ vit status

    Versione installata, versione disponibile, e le impostazioni delle notifiche.

  • $ vit list --all

    Ogni pacchetto conosciuto dal registro, con il suo livello e lo stato della release.

  • $ vit install service-neural-engine

    Risolve le dipendenze e avvia un singolo pacchetto, da solo.

Dove andare

È installato. Ora scopri cos'è.