Introduzione

Orlok è una piattaforma self-hosted di colleghi virtuali organizzati in uffici. Ogni azienda gestisce la propria installazione, distribuita con Docker, e invita le sue persone via email. Ogni persona crea i propri colleghi nei suoi uffici e lavora con loro dal web, da computer e da telefono.

I colleghi virtuali ricordano quello che l'ufficio sa, grazie a una wiki che tengono aggiornata da soli, e agiscono sui sistemi reali, con approvazioni e un registro completo. Sui server un collega agisce come la persona per cui lavora, mai con più diritti.

Concetti

Concetto	Significato
Installazione	Un'installazione di Orlok appartiene a un'azienda. Parte vuota: la configurazione iniziale crea l'azienda e l'amministratore, e tutto il resto si configura dall'interfaccia.
Ufficio	Un team o un reparto, come un ufficio IT o un helpdesk. Ogni ufficio ha la propria wiki, i propri strumenti MCP e il proprio registro, e i colleghi delle sue persone. La wiki non è mai condivisa né cercata tra uffici diversi.
Collega virtuale	Un assistente di una persona, in uno dei suoi uffici, con un nome, un ruolo, delle istruzioni e un profilo. Lavora solo per quella persona e nessun altro lo vede, amministratori compresi.
Profilo colleghi	Un modello e una modalità (Nega, Chiedi, Accesso completo o Yolo) che stabilisce come un collega esegue i comandi. Gli amministratori concedono i profili alle persone.
Persone	I membri dell'azienda, invitati via email. Ogni persona è amministratore o membro dell'installazione, e responsabile, membro o osservatore di ogni ufficio a cui partecipa.
Credenziale	Un account personale e cifrato di una persona su uno o più host. I suoi colleghi agiscono lì come lei e non possono vederla.
Wiki	La memoria condivisa di un ufficio: pagine Markdown collegate tra loro, con revisioni. I colleghi la consultano prima di rispondere e la aggiornano quando imparano qualcosa di duraturo.
Host	Una macchina che i colleghi possono raggiungere via SSH: nome, indirizzo, porta e sistema, in un unico registro per l'installazione.
Operazioni	I comandi che i colleghi eseguono sugli host o nel runner isolato, secondo la modalità del loro profilo e le approvazioni date dalla persona per cui lavorano.

Componenti

Un'installazione di Orlok esegue tre container:

Container	Ruolo
db	PostgreSQL con pgvector: tutti i dati, compresi la wiki e il suo indice di ricerca
app	API, processi in background e app web, su una sola porta
runner	Container isolato che esegue comandi, sessioni SSH e server MCP locali

Solo l'app pubblica una porta. Il runner non ha accesso al database.

Dove andare ora

• Controlla i requisiti e installa Orlok su un server con Docker.
• Configura i modelli, i profili colleghi, gli uffici e le persone.
• Crea i tuoi colleghi e lavora con loro: conversazioni, approvazioni e la wiki dell'ufficio.