MiroFish è un software open source che trasforma un documento in una simulazione sociale popolata da agenti AI e ne ricava un report previsionale.
Il 7 marzo 2026 il repository 666ghj/MiroFish è salito al primo posto della classifica globale di GitHub Trending. Secondo il portale cinese di venture capital Pedaily, in quei giorni Chen Tianqiao, fondatore del gruppo Shanda, aveva già impegnato 30 milioni di yuan per incubare il progetto. Al 12 ottobre 2026 il repository conta 75.800 stelle e 11.600 fork. Non contiene invece nessuna verifica pubblicata delle sue previsioni contro risultati reali.
Cos’è MiroFish e chi lo ha sviluppato?
MiroFish è opera di Guo Hangjiang, che firma online come BaiFu. Secondo Pedaily, quando il progetto è esploso era uno studente all’ultimo anno di università. Pochi mesi prima aveva pubblicato BettaFish, un assistente multi-agente per l’analisi dell’opinione pubblica arrivato anch’esso in cima alle tendenze di GitHub a fine 2025.
BettaFish analizzava ciò che era già successo. MiroFish prova a simulare ciò che potrebbe succedere. Secondo il portale tecnologico iFeng, Guo lo ha costruito in dieci giorni dentro Shanda, dove Chen Tianqiao lo aveva invitato dopo il successo del primo progetto. Il README del repository conferma il sostegno strategico e l’incubazione da parte di Shanda; la cifra dell’investimento viene dalla stampa cinese, non dal progetto.
Il codice è rilasciato con licenza AGPL-3.0: chiunque può scaricarlo, studiarlo, modificarlo e usarlo gratis, a condizioni precise se lo offre ad altri come servizio online.
Come funziona MiroFish, passo per passo?
Il punto di partenza è un documento che il README chiama “seme”: una notizia, una bozza di legge, un report finanziario, perfino un romanzo. L’utente aggiunge una domanda in linguaggio naturale. Il sistema procede in cinque fasi, descritte così nel repository:
- Costruzione del grafo. Il software estrae dal documento entità e relazioni (persone, organizzazioni, posizioni, conflitti) e le organizza in un grafo di conoscenza interrogabile, con una tecnica nota come GraphRAG.
- Preparazione dell’ambiente. Per ogni entità genera un personaggio con carattere, storia e opinioni iniziali. Sono questi gli “agenti”.
- Simulazione. Gli agenti pubblicano, commentano e reagiscono in parallelo su due piattaforme simulate, una che imita Twitter e una che imita Reddit, per un numero di turni deciso dall’utente. A ogni turno la loro memoria si aggiorna.
- Report. Un agente dedicato, il ReportAgent, legge cosa è accaduto nella simulazione e scrive la previsione.
- Interrogazione. Si può chattare con qualsiasi agente del mondo simulato o fare domande al ReportAgent.
Un esempio pubblicato dal progetto dà l’idea della scala. Partendo dai primi 80 capitoli del Sogno della camera rossa, il classico cinese rimasto senza finale, MiroFish ha costruito secondo iFeng una mappa di 905 entità e 3.822 relazioni, poi ha simulato come la storia potrebbe proseguire.
Un dettaglio cambia la lettura di tutto il resto: ogni agente è lo stesso modello linguistico che interpreta un ruolo diverso. Mille agenti non sono mille persone, ma un unico modello che recita mille parti.
Cosa c’è sotto il motore: OASIS, grafi e memoria
La simulazione sociale non l’ha scritta il team di MiroFish. Il README dichiara di usare OASIS (Open Agent Social Interaction Simulations), un simulatore open source del gruppo CAMEL-AI presentato su arXiv il 19 novembre 2024 da ricercatori dello Shanghai Artificial Intelligence Laboratory, di Oxford, KAUST e altri istituti.
OASIS riproduce le meccaniche di un social network vero, compreso un algoritmo di raccomandazione che decide quali post vede ciascun agente, e secondo i suoi autori regge fino a un milione di agenti. Gli stessi autori hanno confrontato le simulazioni con dati umani e hanno osservato che gli agenti seguono l’opinione della maggioranza più facilmente delle persone reali. È un limite noto del motore, e MiroFish lo eredita.
Attorno a OASIS, MiroFish aggiunge l’estrazione del grafo, la generazione dei personaggi, la memoria e il report. Servono due servizi esterni:
- un modello linguistico raggiungibile con un’interfaccia compatibile con quella di OpenAI. Il README consiglia Qwen-plus di Alibaba tramite la piattaforma Bailian e avverte che il consumo è alto: meglio provare prima simulazioni sotto i 40 turni;
- un account Zep Cloud, il servizio che conserva la memoria degli agenti. Il README indica che la quota mensile gratuita basta per un uso semplice.
I requisiti tecnici per installarlo sono Node.js 18 o successivo e Python tra 3.11 e 3.12, oppure Docker.
MiroFish prevede davvero qualcosa? Il test di WPP
Non esiste una dimostrazione pubblica che MiroFish preveda meglio di un’alternativa più semplice. Il repository mostra due esempi, una simulazione di opinione pubblica su un caso dell’Università di Wuhan e il finale del romanzo, e annuncia come “in arrivo” le previsioni finanziarie e politiche.
Il test indipendente più dettagliato che abbiamo trovato è del laboratorio di ricerca di WPP, il gruppo pubblicitario britannico. Lo firma Nikos, data scientist di Satalia, società di WPP. L’idea era semplice: ogni mattina, prima dell’apertura di Wall Street, chiedere a MiroFish se l’S&P 500 avrebbe chiuso in rialzo o in ribasso e quali cinque titoli sarebbero saliti di più. In parallelo, gli stessi dati e la stessa domanda andavano a una singola chiamata a Gemini, senza sciame e senza memoria.
Il test previsto su più giorni si è ridotto a una sola giornata completa, il 14 maggio 2026.
| Domanda | MiroFish (circa 25 agenti) | Gemini, singola chiamata | Cosa è successo |
| Direzione dell’S&P 500 | Ribasso | Ribasso | Rialzo dello 0,77%, da 7.444,25 a 7.501,24 punti |
| I cinque titoli migliori | NVDA, AMZN, META, GOOGL, MSFT | WMT, BABA, DE, AMAT, CAVA | CSCO +13,4%, JBHT +7,1%, APP +7,0%, TTWO +6,8%, F +6,7% |
| Titoli indovinati | 0 su 5 | 0 su 5 (due nemmeno nell’indice) |
Fonte: WPP Research. Le percentuali sono quelle riportate dagli autori.
I cinque titoli scelti dallo sciame coincidono con le più grandi società dell’indice per capitalizzazione, più che con una previsione sulla giornata. Nella sintesi degli autori, lo sciame ha aggiunto complessità senza aggiungere informazione: quando entrambi i sistemi hanno dato una direzione, hanno dato la stessa.
Più dei risultati contano gli ostacoli che il test ha documentato:
- l’immagine Docker pubblicata era vecchia e solo in cinese, ed è stato necessario ricompilarla;
- il software è tarato su Qwen: con Gemini un limite di token fissato nel codice troncava le risposte, finché gli autori non sono passati a un modello più leggero, gemini-2.5-flash-lite;
- il numero di agenti non si sceglie. Lo decide il sistema in base a quante entità trova nel documento. Gli autori ne volevano 100 e ne hanno ottenuti circa 25;
- la quota gratuita di Zep Cloud si è esaurita dopo tre esecuzioni, interrompendo una simulazione a metà;
- MiroFish non consulta il web: sa solo ciò che c’è nel documento caricato e ciò che il modello ha imparato in addestramento.
Il costo dell’intero esperimento è stato di circa un dollaro, perché il modello usato era economico.
Una giornata di Borsa non è un verdetto, e gli autori lo scrivono. Suggeriscono che il metodo possa rendere di più dove contano le prospettive diverse e non la precisione numerica: pianificazione di scenari, discussione di politiche, sintesi di ricerca qualitativa. Ma è un’ipotesi, non un risultato.
Questo articolo ha finalità informative e non costituisce consulenza finanziaria o di investimento.
Quanto costa usare MiroFish?
Il software è gratuito. Si pagano i servizi che lo fanno funzionare, e il conto cresce con il numero di agenti e di turni.
| Opzione | Cosa si paga | Dove passano i documenti | Chi la gestisce |
| Installazione propria dal repository ufficiale | Token del modello linguistico scelto + Zep Cloud oltre la quota gratuita | Fornitore del modello scelto e Zep Cloud | L’utente |
| Demo online del progetto | Nulla | Nessun documento caricato: simulazione già preparata dagli autori | Progetto MiroFish |
| mirofish.my | Da 9 a 49 dollari al mese (da 7,50 a 40,83 con pagamento annuale) | Non dichiarato | Non dichiarato |
Fonti: README GitHub, listino di mirofish.my rilevato il 12 ottobre 2026.
Per orientarsi sul costo dell’installazione propria esiste un solo dato pubblico: circa un dollaro per l’esperimento WPP, con 25 agenti e un modello leggero. Con modelli più capaci e simulazioni più lunghe la cifra sale; quanto, dipende dal listino del fornitore. Una stima generale affidabile non esiste.
mirofish.my è il sito ufficiale di MiroFish?
No. mirofish.my usa nome, logo e video dimostrativi del progetto, ma nel proprio footer si descrive come “independent simulation product” e come un’interfaccia “ricostruita in Next.js”. Il README di GitHub non lo cita e rimanda a mirofish.ai.
Alcuni elementi da tenere presenti prima di registrarsi:
- i termini di servizio, aggiornati al 15 marzo 2026 (otto giorni dopo il picco su GitHub), non indicano la società che gestisce il sito né il paese in cui opera;
- la homepage dichiara “1M+” agenti paralleli per esecuzione. Il progetto originale parla di migliaia di agenti; il milione è il limite del motore OASIS, e nel test WPP il numero reale è stato 25;
- non abbiamo trovato sul sito un collegamento al codice sorgente.
Quest’ultimo punto ha un peso legale preciso. La licenza AGPL-3.0 impone a chi offre in rete una versione modificata del programma di rendere disponibile il codice di quella versione agli utenti. Se invece il servizio è stato riscritto da zero, l’obbligo non si applica. Dall’esterno non è possibile stabilirlo, e non lo affermiamo.
MiroFish in Italia: cosa sapere prima di caricarci un documento aziendale
In Italia MiroFish è stato raccontato soprattutto come la storia dello studente e del miliardario: Money.it gli ha dedicato un articolo il 12 aprile 2026. Per un’azienda o un ente che vuole provarlo contano tre aspetti pratici.
Dove finiscono i dati con la configurazione predefinita. Il file di esempio del README punta a dashscope.aliyuncs.com, l’endpoint di Alibaba Cloud che la stessa Alibaba documenta come regione di Pechino, con archiviazione dei dati in Cina continentale. La Commissione europea non ha adottato una decisione di adeguatezza per la Cina: se il documento contiene dati personali (nomi di clienti, dipendenti, interlocutori), il trasferimento ricade nelle regole del Capo V del GDPR. La soluzione è tecnica e semplice: il software accetta qualsiasi fornitore compatibile, compreso l’endpoint internazionale di Alibaba a Singapore, fornitori europei o un modello locale.
Zep Cloud non si può togliere. Anche con un modello locale, la memoria degli agenti passa da Zep Cloud: il test WPP lo descrive come una dipendenza obbligatoria senza alternativa. Chi tratta documenti riservati deve valutare quel servizio come qualsiasi altro fornitore cloud.
Cosa comporta la licenza. Usare MiroFish internamente, anche modificato, non obbliga a pubblicare nulla. Integrarlo in un servizio offerto ai clienti via web sì: le modifiche vanno rese disponibili con la stessa licenza. Per una software house o un’agenzia è la differenza tra strumento interno e prodotto.
Per le realtà italiane che lavorano su comunicazione, reputazione e affari pubblici, l’uso sensato oggi è quello di generatore di ipotesi: far emergere reazioni e attori che il team non aveva considerato, da verificare poi con metodi tradizionali. Non come previsione.
A cosa può servire MiroFish, realisticamente?
Il valore di MiroFish non sta nel numero che restituisce, ma nella mappa che costruisce. Il grafo di attori e relazioni e la possibilità di interrogare i singoli personaggi sono strumenti utili per ragionare su uno scenario.
Tre limiti vanno tenuti presenti:
- il numero di agenti non è un campione statistico. Sono tutti generati dallo stesso modello a partire dallo stesso documento: più agenti non significano più punti di vista indipendenti;
- gli agenti tendono al conformismo. Lo hanno misurato gli autori di OASIS, il motore che MiroFish usa;
- la previsione è vecchia quanto il documento. Il sistema non cerca informazioni nuove: se il seme è incompleto, lo è anche il mondo simulato.
Chi lo usa per esplorare scenari, preparare una risposta di crisi o testare un messaggio prima del lancio ottiene un esercizio strutturato. Chi lo usa per prevedere Borsa, elezioni o risultati sportivi ottiene, per ora, una risposta non verificata.
Domande frequenti su MiroFish
MiroFish è gratuito? Il software sì, con licenza AGPL-3.0. Per farlo funzionare servono un modello linguistico a pagamento (o locale) e un account Zep Cloud, che ha una quota mensile gratuita limitata.
Qual è il sito ufficiale di MiroFish? Il progetto vive sul repository GitHub 666ghj/MiroFish, che indica come homepage mirofish.ai. mirofish.my è un servizio a pagamento che si dichiara indipendente.
Serve saper programmare per usarlo? Serve saper installare un progetto da GitHub con Node.js e Python, oppure usare Docker, e configurare le chiavi di accesso ai servizi esterni. Il test WPP mostra che può richiedere interventi sul codice.
MiroFish può prevedere la Borsa? Non ci sono prove che lo faccia. Nell’unico test indipendente documentato, il 14 maggio 2026, ha sbagliato la direzione dell’S&P 500 e non ha indovinato nessuno dei cinque titoli migliori.
Dove finiscono i documenti caricati? Con la configurazione suggerita nel README, al servizio di Alibaba Cloud nella regione di Pechino e a Zep Cloud. Il modello linguistico si può sostituire; Zep Cloud no.
Fonti
- 666ghj/MiroFish, README e licenza, GitHub, consultato il 12 ottobre 2026
- 陈天桥投的AI产品登顶Github, Pedaily (da TMTPost), marzo 2026
- 中国最年轻首富,又杀回来了, iFeng Tech, 2026
- MiroFish: Is swarm intelligence worth the cloud bill?, WPP Research, 2026
- OASIS: Open Agent Social Interaction Simulations with One Million Agents, arXiv, 19 novembre 2024
- OASIS, pagina del progetto, CAMEL-AI
- Batch interfaces compatible with OpenAI, Alibaba Cloud Model Studio, documentazione
- Pricing e Terms of Service, mirofish.my, consultati il 12 ottobre 2026
- Come funziona MiroFish, l’AI che prevede il futuro, Money.it, 12 aprile 2026
