Announcing Mastra v1 beta

Mastra v1 is now in beta, marking the production-ready release of the leading TypeScript framework for AI agents, trusted by top global companies.

·

Nov 6, 2025

Last month, Mastra turned one year old.

Today we’re the leading Typescript agent framework with over 220k weekly npm downloads.

Companies like SoftBank, Marsh McLennan and Adobe are running Mastra agents in production. Replit's Agent 3 builds Mastra agents at scale. We raised a $13m seed round from 100+ of Silicon Valley's top investors.

And today, we’re excited to announce that Mastra v1 is now in beta.

What v1 means for you

Mastra v1 doesn’t have new features. We’ve been releasing everything in our 0.21, 0.22 , 0.23, etc.

But because we’re now widely used in production, and we’ve learned what the APIs should be, we’re cutting a 1.0 release.

Some of the things we’ve done in the last few months that are now in v1:

  • refined experimental features like agent.network(), Mastra Auth, and multi-engine workflow support (e.g. Inngest).
  • standardized on new APIs for workflows (in May), evals (in September), and observability (in October)
  • adopted unified signatures, like get for singular objects and list for plural objects.

Migrating to Mastra v1

We'll release a stable version of Mastra v1 in the next few weeks. In the meantime, you can try out the beta release and provide feedback.

Getting started

For new projects, you can start with Mastra v1 using the beta release:

 1npm create mastra@beta

If you want to upgrade an existing project, follow the steps below:

  1. Check out our migration guide.
  2. Use codemods for automatic migration
  3. Join our Discord if you need help

So welcome to Mastra v1. Let's build something amazing.

Share:
Sam Bhagwat

Sam Bhagwat is the founder and CEO of Mastra. He co-founded Gatsby, which was used by hundreds of thousands of developers. A Stanford graduate and veteran of web development, he authored 'Principles of Building AI Agents' (2025).

All articles by Sam Bhagwat