mastra README

The project's README from github.com/mastra-ai/mastra. As one markdown file: README.md.

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:

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:

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 [email protected] and we will get back to you.

mastra (mastra-ai/mastra)

Searching Database…

28.9K ·GitHub
Mastra
Что это такое?Mastra — это TypeScript-фреймворк для создания приложений и агентов на базе ИИ, рассчитанный на путь от ранних прототипов до продуктов, готовых к продакшену.
Это готовое приложение, которое я устанавливаю, или инструмент, на основе которого я строю свой продукт?Это фреймворк, а не готовый продукт: его агенты и воркфлоу встраиваются в ваш код на React, Next.js или Node.js либо разворачиваются как отдельный сервер.
С чего начать и что нужно иметь заранее?Работать нужно на современном TypeScript-стеке поверх Node.js. Рекомендуемый путь — запустить команду Mastra CLI из раздела Get started; ручная установка описана в гайде Installation.
Всё здесь open source, или есть подвох?В основном да: ядро фреймворка — под Apache-2.0, но код в любых каталогах ee/ распространяется по Mastra Enterprise License — бесплатно для разработки и тестирования, а для использования в продакшене нужна действующая enterprise-лицензия.
Почему выбрать Mastra, а не обращаться к API моделей напрямую?Он включает готовые устоявшиеся AI-паттерны — маршрутизацию моделей, агентов, оркестрацию воркфлоу, память и evals — прямо из коробки в едином TypeScript-стеке, так что вам не придётся собирать все эти детали самостоятельно на пути от прототипа к продакшену.
Я новичок в AI-агентах — есть ли материалы для обучения?Да: для новичков в проекте есть готовые шаблоны, курс и видео на YouTube, а также открытый Discord-комьюнити, где можно задавать вопросы и получать помощь с запуском.
Как выглядит синтаксис воркфлоу?Воркфлоу строятся на графах и используют понятный синтаксис управления потоком: .then(), .branch() и .parallel() для последовательного выполнения, ветвления и параллельного запуска шагов.
What are similar projects?voltagent, harness-sdk, ruflo, open-multi-agent, agentscope, hive, turnstone, evenfire
Which topics is it in?ai-framework, chatbots, evals, workflows, human-in-the-loop, reactjs, tts, agent-framework, agent-memory, memory, monorepo, orchestration
Creator
mastra-ai
Size
2 GB
Stars
28.9K
Updated
CommitOct 18Release@mastra/[email protected]Oct 16
Age
2y
Commits · 90 Days