Announcing Mastra v1 beta

·

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:

npm 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.

Stay up to date