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

Go 55.9%
Python 43.7%
Shell 0.4%

Find a file

claudia 96708dc83d Merge pull request 'feat(gateway): forza una versione minima del runner all'hello' (#2 ) from feat/gateway-min-runner-version into main		2026-06-17 16:57:02 +00:00
agent-runner	fix(runner): ticket_id tollerante (int o stringa) + bump 0.6.6	2026-06-17 16:34:46 +00:00
docs	feat(gateway): endpoint /provision e /revoke per token agente a runtime	2026-06-03 09:52:48 +02:00
gateway	feat(gateway): forza una versione minima del runner all'hello	2026-06-17 14:06:15 +00:00
.gitignore	chore: baseline del repo (README, licenza, gitignore)	2026-06-02 00:27:19 +02:00
DESIGN.md	feat: scaffold gateway (Python) + agent-runner (Go) + design	2026-06-02 00:28:11 +02: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).