Mastra

Mastra — фреймворк для создания AI-приложений и агентов на современном TypeScript-стеке.

Включает всё необходимое для перехода от ранних прототипов к production-готовым приложениям. Mastra интегрируется с фронтенд- и бэкенд-фреймворками: React, Next.js и Node, а также может быть развёрнута как самостоятельный сервер. Это самый простой способ создавать, настраивать и масштабировать надёжные AI-продукты.

Почему Mastra?

Создана специально для TypeScript и построена вокруг устоявшихся AI-паттернов — Mastra даёт всё необходимое для разработки качественных AI-приложений прямо из коробки.

Основные возможности:

• Маршрутизация моделей — подключение к 40+ провайдерам через единый стандартный интерфейс. Поддержка моделей OpenAI, Anthropic, Gemini и других.

• Агенты — создание автономных агентов, использующих LLM и инструменты для решения открытых задач. Агенты рассуждают о целях, выбирают инструменты и итерируют внутренне до получения финального ответа или достижения условия остановки.

• Воркфлоу — когда требуется явный контроль над выполнением, используйте граф-ориентированный движок воркфлоу Mastra для оркестрации сложных многошаговых процессов. Воркфлоу Mastra используют интуитивный синтаксис управления потоком (.then(), .branch(), .parallel()).

• Human-in-the-loop — приостановка агента или воркфлоу с ожиданием ввода или подтверждения от пользователя перед возобновлением. Mastra использует хранилище для сохранения состояния выполнения, что позволяет делать паузу на неопределённое время и продолжать с того места, где остановились.

• Управление контекстом — предоставление агентам нужного контекста в нужный момент. Поддержка истории диалога, извлечения данных из источников (API, базы данных, файлы), а также человекоподобной рабочей и семантической памяти для согласованного поведения агентов.

• Интеграции — встраивание агентов и воркфлоу в существующие React, Next.js или Node.js приложения, либо публикация в виде самостоятельных эндпоинтов. При разработке UI — интеграция с агентными библиотеками Vercel AI SDK UI и CopilotKit для создания AI-ассистентов в вебе.

• MCP-серверы — создание серверов Model Context Protocol, предоставляющих агентов, инструменты и другие структурированные ресурсы через MCP-интерфейс. Доступны из любой системы или агента, поддерживающего протокол.

• Production-инструменты — надёжная работа агентов требует постоянного наблюдения, оценки и итерации. Встроенные эвалы и наблюдаемость позволяют непрерывно отслеживать, измерять и улучшать качество.

Начало работы

Рекомендуемый способ начать работу с Mastra — выполнить команду:

Следуйте руководству по установке для пошаговой настройки через CLI или ручной установки.

Если вы только знакомитесь с AI-агентами, ознакомьтесь с шаблонами, курсом и видео на YouTube, чтобы начать разработку с Mastra уже сегодня.

Документация

Посетите официальную документацию.

Разработка с помощью AI

Узнайте, как сделать вашего агента экспертом по Mastra, следуя руководству по разработке с AI.

Участие в разработке

Хотите внести вклад? Приветствуется любая помощь — от написания кода до тестирования и спецификации функций. Прочитайте CONTRIBUTING.md для получения подробной информации об участии в проекте.

Если вы разработчик и хотите внести вклад кодом, пожалуйста, откройте issue для обсуждения перед созданием Pull Request.

Информация о настройке проекта находится в документации по разработке.

Поддержка

У нас есть открытое сообщество в Discord. Присоединяйтесь, задавайте вопросы и обращайтесь за помощью.

Также будем рады, если вы поставите проекту звезду в верхней части страницы.

Лицензирование

Репозиторий использует двойную модель лицензирования:

• Apache License 2.0 — основной фреймворк и подавляющее большинство кодовой базы распространяются как открытый исходный код под лицензией Apache-2.0.
• Mastra Enterprise License — код в директориях с именем ee/ (например, packages/core/src/auth/ee/) доступен как source-available под лицензией Mastra Enterprise License. Эти функции требуют действующей корпоративной лицензии для использования в production, но могут свободно использоваться для разработки и тестирования.

См. LICENSE.md для полного описания лицензий и ee/LICENSE для условий корпоративной лицензии.

Безопасность

Мы привержены поддержанию высоких стандартов безопасности проекта.