Cairn

Più che solo test di penetrazione AI — Verso la ricerca generale dello spazio degli stati

Cairn è un motore di problem-solving generico.
Non definisce ruoli né flussi di lavoro. Dati un'origine e un obiettivo, cerca un percorso attraverso uno spazio degli stati sconosciuto.
Il test di penetrazione AI è uno di questi problemi — e uno comprovato.

Cos'è Cairn?

Il test di penetrazione è fondamentalmente una ricerca diretta attraverso uno spazio degli stati quasi infinito:

• Origine: nota (IP target, sistema target)
• Obiettivo: definito (ottenere una shell, catturare la bandiera)
• Percorso: sconosciuto

Questa struttura non è unica per il test di penetrazione. Ricerca di vulnerabilità, dimostrazione matematica, sfide CTF — qualsiasi problema con un punto di partenza chiaro, una condizione di successo chiara e un percorso sconosciuto intermedio condivide la stessa forma.

Cairn è costruito per questa classe di problemi. Il test di penetrazione è il primo dominio su cui è stato validato.

Il motore è costruito su una Architettura Blackboard con un grafico esplicito fatto-intento. Sono sufficienti tre primitive:

Il grafico cresce da origin verso goal. Ogni nuovo Fatto è una pietra miliare; ogni Intento è un passo verso l'ignoto.

Gli Agent Workers eseguono un ciclo OODA — Observe (osserva) il grafico completo, Orient (orienta) allo stato corrente, Decide (decidi) i prossimi intenti, Act (agisci) per esplorare — e scrivono i loro risultati come nuovi Fatti. I Workers non hanno ruoli fissi. I compiti vengono generati a runtime dallo stato corrente del grafico, non da descrizioni predefinite.

Gli agenti si coordinano esclusivamente attraverso la bacheca condivisa (Stigmergia). Nessuna comunicazione diretta. Nessun silo informativo.

Cairn in Azione

https://github.com/user-attachments/assets/e557b1ac-dda4-41cb-87dd-9d56dbf05133

Come Funziona

Tre tipi di compito, tutti eseguiti dallo stesso Worker:

Architettura del sistema:

          ┌──────────────────────────────────┐
          │           Cairn Server           │
          │    Facts + Intents + Hints       │
          └─────────────────┬────────────────┘
                            │
                     Read / Write API
                            │
          ┌─────────────────┴────────────────┐
          │             Dispatcher           │
          │   Schedules tasks, manages       │
          │   containers, writes protocol    │
          └──────────┬───────────────┬───────┘
                     │               │
     ┌───────────────┴──┐     ┌──────┴──────────────┐
     │  Worker Container│     │  Worker Container   │
     │   (Project A)    │     │   (Project B)       │
     │  ┌────┐  ┌────┐  │     │  ┌────┐  ┌────┐     │
     │  │ W. │  │ W. │  │     │  │ W. │  │ W. │     │
     │  └────┘  └────┘  │     │  └────┘  └────┘     │
     └──────────────────┘     └─────────────────────┘

Cairn Server mantiene solo la coerenza del grafico.

Cairn Dispatcher legge il grafico, pianifica i compiti, avvia e arresta i container worker, ed è l'unico scrittore del protocollo. Ogni progetto ottiene il proprio Worker Container; più Agent Workers vengono eseguiti contemporaneamente al suo interno. Gli Agent Workers ricevono solo un prompt e restituiscono output strutturato.

Backend worker supportati: Claude Code, Codex e Pi.

Risultati

Tencent Cloud Hackathon · Sfida di Test di Penetrazione AI · 2a Edizione

610 squadre · 1.345 partecipanti · le migliori università e aziende di sicurezza in tutta la Cina

Il sistema non era mai stato testato prima della competizione. L'intera pipeline è diventata operativa per la prima volta alle 4 del mattino del giorno della gara. Nessun addestramento, nessuna ottimizzazione, nessuna strumentazione specifica del dominio. Zero strumenti MCP, zero RAG, zero ruoli predefiniti per agenti.

Ulteriori Letture

• Il più potente agente di test di penetrazione AI: Analisi post-mortem dell'unica squadra che ha ottenuto AK alla TCH Tencent Cloud Hackathon Intelligent Penetration Testing Challenge (2a Edizione)
• Il sentiero senza percorso: Cairn AI dal test di penetrazione alla risoluzione generale di problemi

Per Iniziare

Prerequisiti

• macOS o Linux
• Python ≥ 3.12
• Docker

Scarica le immagini richieste

Entrambi i metodi di configurazione richiedono l'immagine del container worker:

docker pull --platform=linux/amd64 ghcr.io/oritera/cairn-worker-container:latest

Crea la tua configurazione dispatcher locale e inserisci i tuoi endpoint LLM e le chiavi API:

cp dispatch.example.yaml dispatch.yaml

Docker Compose (consigliato)

Scarica l'immagine base usata per costruire Cairn:

docker pull ghcr.io/astral-sh/uv:python3.13-trixie

docker compose up --build

Questo avvia cairn-server sulla porta 8000 e cairn-dispatcher una volta che il server supera il controllo di salute. Il dispatcher monta dispatch.yaml dalla radice del progetto e si connette a Docker tramite il socket host. I dati vengono persistiti in ./datas/cairn/.

Manuale

# Start the server
uv run --project cairn cairn serve
 
# Run the dispatcher
uv run --project cairn cairn dispatch --config dispatch.yaml
 
# Run startup health checks only
uv run --project cairn cairn dispatch --config dispatch.yaml --startup-healthcheck-only

Test

Esegui la suite di regressione rapida senza Docker o endpoint di modelli live:

uv run --project cairn --group dev pytest

Dichiarazione di non responsabilità

Cairn è un motore di problem-solving generico. Sebbene supporti flussi di lavoro di test di penetrazione, risoluzione di CTF, valutazione della sicurezza e ricerca di vulnerabilità, è inteso per essere utilizzato solo in ambienti in cui si dispone di esplicita autorizzazione ad operare.

Sei l'unico responsabile per come utilizzi questo progetto. Non usare Cairn contro sistemi, reti, applicazioni o dati senza un chiaro permesso preventivo del proprietario o gestore. Test di sicurezza, sfruttamento o accesso ai dati non autorizzati possono essere illegali e causare danni.

Gli sviluppatori e i contributori di questo progetto non approvano né accettano responsabilità per qualsiasi uso improprio, abuso, danno, perdita o conseguenze legali derivanti dal suo utilizzo. Usando questo progetto, accetti di garantire che le tue attività siano conformi a tutte le leggi, normative, obblighi contrattuali e politiche professionali o organizzative applicabili nella tua giurisdizione.

Cronologia Stelle

⚖️ Licenza

Questo progetto è concesso in licenza GNU AGPLv3 per uso personale ed educativo.

Uso commerciale: Se desideri utilizzare questo progetto in un ambiente commerciale o proprietario senza gli obblighi open-source AGPL-3.0, contattami per ottenere una licenza commerciale.

Contributi: Inviando una Pull Request, accetti che i tuoi contributi possano essere utilizzati sia sotto AGPL-3.0 che sotto la licenza commerciale del progetto.