Artefatto di ricerca automatizzato — non è il progetto upstream.

Questo repository è un laboratorio usa e getta costruito da un sistema automatizzato per una tesi magistrale presso l'Université Laval sulla riproduzione di vulnerabilità pubblicate nei workflow di GitHub Actions. È uno snapshot integrale di mesa/mesa al commit 821c14475afebc6a68a45bb4b8e87be4d36a0c41 (2026-03-04), ridistribuito sotto la licenza del progetto stesso, il cui file è incluso invariato in questo snapshot.

Il progetto upstream non è coinvolto, non è mai preso di mira, e la vulnerabilità studiata qui è già pubblica. Ogni segreto e variabile in questo repository è un valore fittizio generato casualmente — nessuna credenziale reale è presente. I riferimenti alle action e le immagini dei runner sono bloccati a ciò a cui risolvevano il 2026-03-04; consulta pinning.md nell'output del sistema per ogni modifica apportata allo snapshot.

Domande o obiezioni: [email protected]

---

Per il GSoC, consulta la nostra guida Google Summer of Code 2026

Mesa: Modellazione basata su agenti in Python

CI/CD
Pacchetto
Meta
Chat
Citazione

Mesa consente agli utenti di creare rapidamente modelli basati su agenti utilizzando componenti core integrati (come griglie spaziali e scheduler di agenti) o implementazioni personalizzate; visualizzarli tramite un'interfaccia basata su browser; e analizzarne i risultati utilizzando gli strumenti di analisi dati di Python. Il suo obiettivo è essere l'alternativa basata su Python a NetLogo, Repast o MASON.

Sopra: Un'implementazione Mesa del modello WolfSheep, che può essere visualizzata in finestre del browser o in Jupyter. Una demo online è disponibile qui.

Caratteristiche

• Componenti modulari
• Visualizzazione basata su browser
• Strumenti integrati per l'analisi
• Libreria di modelli di esempio

Usare Mesa

Per installare la nostra ultima versione stabile, esegui:

pip install -U mesa

A partire da Mesa 3.0, non installiamo più tutte le nostre dipendenze per impostazione predefinita.

# Puoi personalizzare le dipendenze aggiuntive di cui hai bisogno, se vuoi. Disponibili sono:
pip install -U "mesa[network,viz]"

# Questo equivale alle nostre dipendenze consigliate:
pip install -U "mesa[rec]"

# Per installare tutto, incluse le dipendenze di sviluppo:
pip install -U "mesa[all]"

Puoi anche usare pip per installare l'ultima versione da GitHub:

pip install -U -e git+https://github.com/mesa/mesa@main#egg=mesa

O qualsiasi altro branch (di sviluppo) di questo repository o del tuo fork:

pip install -U -e git+https://github.com/YOUR_FORK/mesa@YOUR_BRANCH#egg=mesa

Risorse

Per risorse o aiuto sull'uso di Mesa, consulta quanto segue:

• Per iniziare (Una raccolta di tutorial che ti guideranno attraverso un modello di base.)
• GSoC at Mesa — Guida per i candidati (Per i candidati interessati a partecipare al Google Summer of Code presso Mesa)
• Esempi Mesa (Un repository di ABM fondamentali che fanno parte dell'installazione Mesa[rec] e utilizzano la versione più recente di Mesa)
• Documentazione (La documentazione di Mesa, l'API e frammenti utili)
  • Documentazione della versione di sviluppo (la documentazione dell'ultima versione se stai usando una versione pre-release di Mesa)
• Discussioni (Discussioni threadate su GitHub riguardanti Mesa)
• Chat Matrix (Forum di chat via Matrix per parlare di Mesa)

Eseguire Mesa in Docker

Puoi eseguire Mesa in un container Docker in diversi modi.

Se sei uno sviluppatore di Mesa, prima installa Docker Compose e poi, nella cartella che contiene il repository Git di Mesa, esegui:

$ docker compose up
# Se vuoi farlo girare in background, esegui invece
$ docker compose up -d

Questo esegue il modello Schelling, come esempio.

Con il file docker-compose.yml in questo repository Git, il comando docker compose up fa due cose importanti:

• Monta la directory root di mesa (relativa al file docker-compose.yml) in /opt/mesa ed esegue pip install -e su quella directory, così le tue modifiche a mesa dovrebbero riflettersi nel container in esecuzione.
• Collega la porta 8765 del container Docker alla porta 8765 del tuo sistema host, così puoi interagire con il modello in esecuzione come al solito visitando localhost:8765 nel tuo browser

Se sei uno sviluppatore di modelli che vuole eseguire Mesa su un modello, devi:

• assicurarti che la cartella del tuo modello sia all'interno della cartella che contiene il file docker-compose.yml
• modificare la variabile MODEL_DIR in docker-compose.yml per puntare al percorso del tuo modello
• assicurarti che la cartella del modello contenga un file app.py

Quindi, devi solo eseguire docker compose up -d per averlo accessibile da localhost:8765.

Contribuire a Mesa

Vuoi unirti al team di Mesa o sei solo curioso di sapere cosa sta succedendo con Mesa? Puoi...

• Unisciti alla nostra stanza di chat Matrix in cui domande, problemi e idee possono essere discusse (in modo informale).
• Partecipa a una sessione di sviluppo mensile (puoi trovare orari delle sessioni di sviluppo, ordini del giorno e note su Discussioni Mesa).
• Dai un'occhiata al codice su GitHub.

Se incontri un problema, per favore apri un ticket per discuterne. Se possibile, proponi una pull request.