Gateway per orchestrare agenti Claude Code remoti (gateway Python + agent-runner Go). Migrato da GitHub SolteaSrl.

Go 56.7%
Python 39.3%
HTML 3.2%
Shell 0.5%
PowerShell 0.3%

Find a file

Claudia Soltea fe04119329 Merge pull request 'chore(runner): versione 1.0.3' (#28 ) from chore/runner-1.0.3 into main		2026-10-08 13:40:40 +00:00
agent-runner	chore(runner): versione 1.0.3	2026-10-08 13:40:38 +00:00
docs	feat(tray): gestione progetti del servizio dal tray (ticket 74770)	2026-10-06 09:41:31 +00:00
gateway	feat(gateway): /version.json con il commit in esecuzione (ticket 74770)	2026-10-06 10:12:34 +00:00
.gitignore	fix(gateway): orfanaggio per connessione + esito del runner dentro il wake	2026-09-10 20:55:57 +00:00
DESIGN.md	feat(launcher): avvia e aggiorna agent-tray.exe insieme al worker	2026-09-11 14:45:34 +00:00
LICENSE	chore: baseline del repo (README, licenza, gitignore)	2026-06-02 00:27:19 +02:00
README.md	chore: baseline del repo (README, licenza, gitignore)	2026-06-02 00:27:19 +02:00

README.md

soltea-agent-gateway

Gateway di orchestrazione che mette in comunicazione Claudia (l'orchestratrice AI di Soltea) con una flotta di agenti Claude Code che girano su ambienti di sviluppo remoti (VM Windows), uno per progetto.

Tutti i nodi stanno dietro NAT: il gateway è l'unico punto pubblico e fa da centralino. Sia l'orchestratrice sia gli agent-runner aprono una connessione WebSocket in uscita verso il gateway, che instrada i messaggi e fa da tramite per i file (lo zip del ticket).

 Claudia ──WSS──▶  GATEWAY (pubblico, dietro nginx/443)  ◀──WSS── agent-runner (VM Windows) ─▶ claude.exe ─▶ repo progetto
                   • registry agente↔progetto (in RAM)
                   • routing delle sessioni
                   • blob store per gli zip dei ticket

Componenti

Componente	Linguaggio	Dove gira	Cartella
Gateway	Python (FastAPI + uvicorn)	Ubuntu, accanto all'MCP ]po[, dietro nginx sul 443	`gateway/`
Agent-runner	Go (singolo `.exe`, servizio Windows)	VM Windows di sviluppo	`agent-runner/`

Documentazione

DESIGN.md — architettura, flusso end-to-end, deployment.
docs/PROTOCOL.md — protocollo di rete (frame JSON su WSS).
gateway/README.md — avvio e configurazione del gateway.
agent-runner/README.md — build, install come servizio Windows.

Stato

Scaffold iniziale: impianto, protocollo e happy-path implementati. I punti che richiedono un ambiente live (integrazione reale con claude.exe su Windows, installazione come servizio, TLS/nginx in produzione) sono marcati TODO(live).