Mastra Factory: dagli issue al codice con agenti IA

Mastra Factory è un ambiente open source per sviluppare software con agenti IA. Riunisce repository, attività, pianificazione, implementazione e revisione delle pull request. Aiuta gli sviluppatori a delegare modifiche mantenendo il controllo sui requisiti, sul piano e sull’accettazione del risultato.

In parole semplici, a cosa serve Mastra Factory?

Immagina di aprire un issue per un errore nell’applicazione. Un agente può esaminare il progetto, preparare un piano, modificare i file ed eseguire controlli. Il team legge poi la modifica e decide se integrarla. Factory organizza questa sequenza e conserva il contesto della richiesta.

Può essere usato per funzionalità, bug, refactoring e test su codice esistente. L’output utile è una modifica verificabile con una pull request, non soltanto un frammento da copiare. Occorrono comunque accesso al repository, un modello e un ambiente di esecuzione configurato.

Pianificazione e revisione dentro il lavoro quotidiano

Le fasi Intake, Triage, Planning, Building, Review e Done rendono visibile l’avanzamento. Le regole possono adattare il percorso al tipo di attività. Le persone chiariscono i requisiti e possono correggere il piano prima dell’implementazione.

Ogni attività mantiene la propria sessione. La pull request ha invece un elemento di revisione e una sessione separati. Il merge di un PR non garantisce quindi che la richiesta iniziale sia del tutto risolta: potrebbero servire altri interventi. Per chiudere il lavoro bisogna tornare ai criteri di accettazione.

Provare una prima modifica su GitHub

Segui la guida ufficiale per il percorso con server locale e risorse della piattaforma:

1. Esegui npm create factory@latest my-factory fuori dal repository da modificare e completa la configurazione.
2. Imposta una sola volta FACTORY_CREDENTIAL_ENCRYPTION_KEY in .env. Se manca, la guida indica openssl rand -base64 32. Conserva una copia sicura: sostituire la chiave può impedire la lettura delle credenziali salvate.
3. Avvia npm run dev, apri l’indirizzo mostrato e collega GitHub e il fornitore del modello. Linear è facoltativo.
4. Abilita gli issue in Settings → Work Intake e seleziona il repository. Il permesso di accesso al codice è distinto dalla sottoscrizione agli issue.
5. Crea un compito ristretto, per esempio aggiornare il README, con criteri di accettazione espliciti. Nel primo test lascia disattivati avvio automatico e approvazione automatica dei piani.
6. Esamina l’indagine, chiarisci i dubbi e approva il piano. Dopo il lavoro, controlla diff, output degli strumenti e verifiche del PR prima del normale merge.

Dove eseguire Factory e come gestire i dati

Puoi utilizzare la piattaforma completa, un server locale con servizi Mastra oppure infrastruttura interamente tua. Il server locale può ancora dipendere da autenticazione, PostgreSQL e sandbox cloud: non equivale a elaborazione completamente locale.

L’opzione --no-platform richiede di configurare autenticazione, database persistente ed esecuzione. La produzione richiede un processo Node.js continuo e HTTPS con streaming. Consulta i requisiti di distribuzione.

L’accesso ai modelli dipende dall’account del fornitore; credenziali personali e di organizzazione hanno ambiti diversi. Non inserire segreti negli issue. Leggi l’informativa sulla privacy e le condizioni dei fornitori di modelli e sandbox prima di affidare codice riservato.

Tariffe e limiti della licenza

Il 10 settembre 2026 la pagina ufficiale in USD mostra Starter a 0 dollari al mese, con 100.000 eventi di osservabilità, 24 ore CPU e 15 giorni di conservazione. Teams è indicato a 250 dollari al mese; Enterprise è su preventivo.

Non si tratta di utilizzo illimitato degli agenti. Modelli, consumi aggiuntivi e infrastruttura incidono sulla spesa. Verifica il listino completo, senza considerare queste cifre come prezzi locali in euro comprensivi d’imposte. La licenza ufficiale distingue il codice Apache 2.0 dalle funzioni enterprise nelle cartelle ee/, che richiedono una licenza valida in produzione.

Domande frequenti

Posso utilizzare un repository esistente?

Sì. Collega GitHub e configura l’intake degli issue. Non è necessario ricreare l’applicazione; Linear è opzionale.

È tutto gratuito?

No. La base open source e il piano gratuito non eliminano costi di modelli, hosting, consumi eccedenti o licenze enterprise.

Il server locale mantiene tutti i dati sul computer?

Non automaticamente. Bisogna verificare insieme server, autenticazione, storage, modello e sandbox.

Chi decide se accettare il codice?

Il team può rivedere i piani e decidere il merge della pull request. Le regole delle fasi stabiliscono quanta automazione consentire.

Risorse ufficiali

• Documentazione Factory — avvio e configurazione.
• GitHub Mastra — sorgenti e segnalazioni.
• Discord ufficiale — confronto tra sviluppatori.
• Mastra su X — annunci.
• Contatta il team — demo e richieste enterprise.