0
Fork 0
mirror of https://github.com/mastra-ai/mastra.git synced 2026-11-17 08:44:46 +00:00
From the team behind Gatsby, Mastra is a framework for building AI-powered applications and agents with a modern TypeScript stack. https://mastra.ai
  • TypeScript 99.2%
  • JavaScript 0.6%
  • CSS 0.1%
Find a file
Joel Smith f23aaea9a7
chore: update Enterprise Edition license (#24708)
Updates the repository's Enterprise Edition license from Version 1.0 to
Version 2.0, effective September 22, 2026. The new terms define
Enterprise Features, Development and Testing, Production Use,
license-key requirements, agreement precedence, termination, and general
legal terms.\n\nTest plan: reviewed the rendered license text and ran
`git diff --check`. No package changes or runtime tests are required for
this license-only update.
<!-- devin-review-badge-begin -->

---

<a href="https://app.devin.ai/review/mastra-ai/mastra/pull/24708"
target="_blank"><picture><source media="(prefers-color-scheme: dark)"
srcset="https://static.devin.ai/assets/gh-devin-review-dark.svg?v=4"><img
src="https://static.devin.ai/assets/gh-devin-review-light.svg?v=4"
alt="Devin Review"></picture></a>
<!-- devin-review-badge-end -->

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## ELI5

This PR replaces the Enterprise Edition license with clearer Version 2.0
terms. It explains what users may do during development and what is
required for production use.

## Summary

- Updates `ee/LICENSE` to Version 2.0, effective September 22, 2026.
- Defines Enterprise Features and Development and Testing.
- Requires a written agreement and valid License Key for Production Use.
- Adds rules for modifications, redistribution, hosted services, License
Keys, entitlement checks, termination, and third-party components.
- Defines agreement precedence and general legal terms.
- Makes no code or package changes.

## Testing

- Review the rendered license text.
- Run `git diff --check`.
- Runtime tests are not required.

<!-- end of auto-generated comment: release notes by coderabbit.ai -->
History 2026-09-23 16:19:37 -07:00
.agents/skills fix: add missing frontmatter to .agents/skills/testing-core-processors (#22849) 2026-09-01 21:49:13 -07:00
.changeset fix(inngest): stop function-level retries from re-running failed steps (#24842) 2026-09-23 16:15:48 -07:00
.claude refactor(playground-ui): one material for every control surface (#24562) 2026-09-22 08:31:13 +02:00
.cursor Refactor GitHub triage command and consolidate skills (#19106) 2026-07-10 16:17:08 +02:00
.dev chore(deps): update docker images (#19042) 2026-07-07 13:52:18 +02:00
.github fix(ci): fetch only main's history when publishing to npm (#24805) 2026-09-23 12:13:22 +02:00
.husky chore(husky): use pnpm version from package.json in pre-commit (#18419) 2026-06-24 12:47:15 +02:00
.mastracode chore(mastracode): replace understand-pr and understand-issue skills (#24625) 2026-09-21 20:21:14 -07:00
.opencode Refactor GitHub triage command and consolidate skills (#19106) 2026-07-10 16:17:08 +02:00
.superset add superset config (#12387) 2026-01-27 19:06:19 -08:00
agent-sdks chore: version - exit prerelease mode 2026-09-03 04:02:53 +00:00
auth chore: version - exit prerelease mode 2026-09-23 09:15:38 +00:00
browser chore: version - exit prerelease mode 2026-09-23 09:15:38 +00:00
channels chore: version - exit prerelease mode 2026-09-22 10:43:03 +00:00
client-sdks feat(agent): support thread-wide pending input cancellation (#23942) 2026-09-23 16:42:36 -04:00
code-mode chore: version - exit prerelease mode 2026-09-23 09:15:38 +00:00
deployers chore: version packages 2026-09-23 16:05:15 +00:00
docs fix(inngest): stop function-level retries from re-running failed steps (#24842) 2026-09-23 16:15:48 -07:00
e2e-tests security: Vanta zero pass 2026-09-23 (grpc/compression/provider-utils floors) (#24848) 2026-09-23 13:58:39 -07:00
ee chore: update Enterprise Edition license (#24708) 2026-09-23 16:19:37 -07:00
embedders/voyageai chore: version - exit prerelease mode 2026-09-03 04:02:53 +00:00
examples security: Vanta zero pass 2026-09-23 (grpc/compression/provider-utils floors) (#24848) 2026-09-23 13:58:39 -07:00
explorations chore: version packages 2026-09-23 16:05:15 +00:00
integrations chore: version packages 2026-09-23 16:05:15 +00:00
mastracode feat(factory): start new Slack sessions on the sender's own settings (#24816) 2026-09-23 23:03:06 +02:00
observability security: Vanta zero pass 2026-09-23 (grpc/compression/provider-utils floors) (#24848) 2026-09-23 13:58:39 -07:00
packages fix(playground-ui): keep PageLayout narrow column from overflowing (#24877) 2026-09-23 14:33:22 -07:00
patches chore: upgrade monorepo to TypeScript 7 (#22459) 2026-08-28 23:55:51 +02:00
pubsub fix(redis-streams): plug pubsub memory leaks in subscriptions, reply topics, and feed acks (#24580) 2026-09-23 12:20:52 -07:00
scripts security: Vanta zero pass 2026-09-23 (grpc/compression/provider-utils floors) (#24848) 2026-09-23 13:58:39 -07:00
server-adapters chore: version packages 2026-09-23 16:05:15 +00:00
signals/github chore: version - exit prerelease mode 2026-09-22 10:43:03 +00:00
stores feat(observability): add tag predicates to advanced trace queries (#24554) 2026-09-23 23:44:29 +05:30
templates docs(templates): title-case incident triage README title, rename KYC template (#24281) 2026-09-17 13:39:36 -07:00
test-fixtures/workflow-builder-canonical feat(mastracode): add dynamic workflow authoring (#21210) 2026-08-11 13:21:08 -07:00
voice chore: version - exit prerelease mode 2026-09-22 10:43:03 +00:00
workflows fix(inngest): stop function-level retries from re-running failed steps (#24842) 2026-09-23 16:15:48 -07:00
workspaces chore: version - exit prerelease mode 2026-09-23 09:15:38 +00:00
.coderabbit.yaml chore: strengthen schema and factory review guidance (#22472) 2026-08-28 12:47:45 +02:00
.gitattributes fix: prevent CRLF conversion of patch files on Windows (#21155) 2026-08-10 14:10:56 +02:00
.gitignore feat(mastracode): simplify Factory local development (#24632) 2026-09-22 07:49:45 -07:00
.mastra-project.json Add Mastra project config 2026-07-24 16:41:55 +00:00
.oxfmtrc.json feat(cli): add Factory API commands (#23226) 2026-09-08 12:07:25 +02:00
.prettierrc chore: eslint fix core (#2522) 2025-02-25 11:43:11 +01:00
.stylelintrc.json feat(playground): migrate to Tailwind CSS v4 (#14772) 2026-03-30 10:49:00 +02:00
AGENTS.md chore: strengthen schema and factory review guidance (#22472) 2026-08-28 12:47:45 +02:00
CLAUDE.md chore(repo): Cleanup files (#15434) 2026-04-16 11:30:13 +02:00
CODE_OF_CONDUCT.md docs: fix abuse contact email in CODE_OF_CONDUCT (#20966) 2026-08-07 13:06:37 -07:00
CONTRIBUTING.md docs: add Factory cross-links and refresh contributor guidance (#23509) 2026-09-10 07:45:21 -07:00
DEVELOPMENT.md docs: fix onboarding quickstart, pnpm version, and template metadata (#23754) 2026-09-15 09:40:58 +02:00
LICENSE.md fix: clarify licensing and include core package license (#22474) 2026-08-27 08:35:15 -07:00
oxlint.config.ts fix: reduce dependency footprint across core and integrations (#23998) 2026-09-16 11:38:54 +02:00
package.json chore: fix deps (#24794) 2026-09-23 12:13:41 +02:00
pnpm-lock.yaml security: Vanta zero pass 2026-09-23 (grpc/compression/provider-utils floors) (#24848) 2026-09-23 13:58:39 -07:00
pnpm-workspace.yaml security: Vanta zero pass 2026-09-23 (grpc/compression/provider-utils floors) (#24848) 2026-09-23 13:58:39 -07:00
README.md docs: fix onboarding quickstart, pnpm version, and template metadata (#23754) 2026-09-15 09:40:58 +02:00
renovate.json fix(security): harden CI and span identifier generation (#23945) 2026-09-15 09:49:55 +02:00
tsconfig.build.json fix type generation (#6588) 2025-08-05 10:47:22 -07:00
tsconfig.json chore: migrate repository formatting to oxfmt (#19807) 2026-07-24 16:18:33 +02:00
tsconfig.node.json chore: upgrade TypeScript from 5.9.3 to 6.0.3 (#15884) 2026-04-29 10:18:03 -07:00
turbo.json chore(playground-ui): rebuild the design system on save during dev:ui (#21646) 2026-08-18 11:04:54 +02:00
vitest.config.observability.ts chore: migrate linting to oxlint (#20173) 2026-07-25 01:04:02 +02:00
vitest.config.ts test(mastracode): repair suites re-enabled by vitest discovery (#24341) 2026-09-17 19:32:03 -07:00

Mastra

npm version CodeQl GitHub Repo stars Discord Twitter Follow NPM Downloads Static Badge

Mastra is a framework for building AI-powered applications and agents with a modern TypeScript stack.

It includes everything you need to go from early prototypes to production-ready applications. Mastra integrates with frontend and backend frameworks like React, Next.js, and Node, or you can deploy it anywhere as a standalone server. It's the easiest way to build, tune, and scale reliable AI products.

Why Mastra?

Purpose-built for TypeScript and designed around established AI patterns, Mastra gives you everything you need to build great AI applications out-of-the-box.

Some highlights include:

  • Model routing: Connect to 40+ providers through one standard interface. Use models from OpenAI, Anthropic, Gemini, and more.

  • Agents: Build autonomous agents that use LLMs and tools to solve open-ended tasks. Agents reason about goals, decide which tools to use, and iterate internally until the model emits a final answer or an optional stopping condition is met.

  • Workflows: When you need explicit control over execution, use Mastra's graph-based workflow engine to orchestrate complex multi-step processes. Mastra workflows use an intuitive syntax for control flow (.then(), .branch(), .parallel()).

  • Human-in-the-loop: Suspend an agent or workflow and await user input or approval before resuming. Mastra uses storage to remember execution state, so you can pause indefinitely and resume where you left off.

  • Context management: Give your agents the right context at the right time. Provide conversation history, retrieve data from your sources (APIs, databases, files), and add human-like memory with Observational Memory so your agents behave coherently.

  • Integrations: Bundle agents and workflows into existing React, Next.js, or Node.js apps, or ship them as standalone endpoints. When building UIs, integrate with agentic libraries like Vercel's AI SDK UI and CopilotKit to bring your AI assistant to life on the web.

  • MCP servers: Author Model Context Protocol servers, exposing agents, tools, and other structured resources via the MCP interface. These can then be accessed by any system or agent that supports the protocol.

  • Production essentials: Shipping reliable agents takes ongoing insight, evaluation, and iteration. With built-in evals and observability, Mastra gives you the tools to observe, measure, and refine continuously.

Get started

The recommended way to get started with Mastra is by running the command below:

npm create mastra@latest

Follow the Installation guide for step-by-step setup with the CLI or a manual install.

If you're new to AI agents, check out our templates, course, and YouTube videos to start building with Mastra today.

Alternative: Use this pre-built prompt to get started
Create a new Mastra project. Mastra is a framework for AI applications and agents on a modern TypeScript stack. Before running the command, ask these questions one at a time and wait for each answer unless it was already provided:

1. Project name? (default: "my-mastra-app")
2. Provider? (required; options: "openai", "anthropic", "google", "xai")

If the provider isn't supported, ask again and list the supported values.

Run: `npm create mastra@latest <project-name> -- --llm <provider>`

The command creates a default Mastra project, installs Mastra skills for detected coding assistants, and initializes Git when appropriate.

After creation, enter the project directory and start the dev server: `npx bgproc start -n <project-name> -w -- npm run dev`

Open Mastra Studio at `http://localhost:4111`. Studio is the interface for building, testing, and managing agents, workflows, and tools.

Also mention that the Mastra model router provides access to thousands of models: https://mastra.ai/models

Documentation

Visit our official documentation.

Build with AI

Learn how to make your agent a Mastra expert by following the Build with AI guide.

Contributing

Looking to contribute? All types of help are appreciated, from coding to testing and feature specification. Read CONTRIBUTING.md for more details on how to get involved.

If you are a developer and would like to contribute with code, please open an issue to discuss before opening a Pull Request.

Information about the project setup can be found in the development documentation

Support

We have an open community Discord. Come and say hello and let us know if you have any questions or need any help getting things running.

It's also super helpful if you leave the project a star here, at the top of the page

Licensing

This repository uses a dual-license model:

  • Apache License 2.0: The core framework and the vast majority of this codebase is open source under Apache-2.0.
  • Mastra Enterprise License: Code in any directory named ee/ (e.g., packages/core/src/auth/ee/) is source-available under the Mastra Enterprise License. These features require a valid enterprise license for production use but can be freely used for development and testing.

See LICENSE.md for the full license mapping and ee/LICENSE for the enterprise license terms.

Security

We are committed to maintaining the security of this repo and of Mastra as a whole. If you discover a security finding we ask you to please responsibly disclose this to us at security@mastra.ai and we will get back to you.