@mastra/core NPM

Future

This is a guide to developing the core package.

Ensure Docker is Installed

If you haven't already, install Docker: (Docker Installation)https://www.docker.com/

Start Docker Containers

Navigate to the .dev directory:cd .dev
Start the Docker containers: docker-compose up -d

This command will spin up the necessary services, including the database and the Inngest server.

Setup Environment Variables

Copy the sample environment variable files: packages/admin/.env.local.sample packages/core/.env.local.sample
Duplicate and rename each .env.local.sample file to .env: cp packages/admin/.env.local.sample packages/admin/.envcp packages/core/.env.local.sample packages/core/.env

Note: We won’t need to do this again after the first setup if the CLI persists credentials.

Install Dependencies for Core Package

Navigate to the core directory:cd packages/core
Install the dependencies:pnpm install

Build and Initialize CLI

Navigate to the cli directory:cd packages/cli
Build the project and run the initialization script:pnpm run build && node dist/index.js init
When prompted, supply the necessary credentials:

Database URL: postgresql://postgres:postgres@localhost:5432/postgres Inngest Server URL: http://localhost:8288

ai llm llms agent agents vectorstore embeddings rag evals memory tools telemetry typescript opentelemetry otel framework

mastra mastra-starter mem0-mastra saket-mastra calling-agent-from-workflow calling-llm-from-workflow freestyle-sandboxes @t-care/mastra examples-create-workflow examples-tool-as-workflow-step examples-calling-agent-from-workflow examples-calling-llm-from-workflow @dnax/ai @diffusionstudio/dapi @serverless/ai @apofasi-core/mastra @aios-labs/mastra @mashh/mcp-agent-proxy @mastra/spotify @mastra/stabilityai @mastra/store-pg @mastra/store-upstash @mastra/stripe @mastra/toolsets @mastra/tts @mastra/twilio @mastra/vector-astra @mastra/vector-chroma @mastra/vector-libsql @mastra/vector-pg @mastra/vector-pinecone @mastra/vector-qdrant @mastra/dane @mastra/google_sheet @mastra/greenhouse @mastra/gusto @mastra/hubspot @mastra/instagram @mastra/intercom @mastra/jira @mastra/lever @mastra/mailchimp @mastra/mcp-weather-server @mastra/vercel @mastra/resend @mastra/rewatch @mastra/salesforce @mastra/salesloft @mastra/sendgrid @mastra/shopify @mastra/slack @mastra/x @mastra/xero @mastra/zendesk @mastra/zoom @mastra/vector-upstash @mastra/vector-vectorize @mastra/discord @mastra/docusign @mastra/dropbox @mastra/elevenlabs @mastra/engine @mastra/figma @mastra/gong @mastra/google @mastra/google_ads @mastra/google_calendar @mastra/google_docs @mastra/google_drive @mastra/google_mail @mastra/admin @mastra/apollo @mastra/asana @mastra/ashby @mastra/attio @mastra/brex @mastra/claude @mastra/clickup @mastra/notion @mastra/openai @mastra/oura @mastra/pinterest @mastra/quickbooks @mastra/client-js @mastra/coda @mastra/composio @alanagoyal/mcp-server @codists/mcp-test @codists/mcp-test-weather @cogito.ai/voice-openai @mseep/mastra-playwright-mcp

6 months ago

6 months ago

9 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

9 months ago

9 months ago

9 months ago

6 months ago

9 months ago

9 months ago

9 months ago

9 months ago

0.0.0-mastra-3123-mcp-server-20250419180157

6 months ago

0.10.6-alpha.0

5 months ago

0.0.0-mastra-2452-core-tracing-sentry-20250507205331

6 months ago

0.2.0-alpha.100

9 months ago

0.2.0-alpha.101

9 months ago

0.2.0-alpha.102

9 months ago

0.0.0-taofeeqInngest-20250603090617

5 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

11 months ago

11 months ago

0.0.0-generate-message-id-20250512171942

6 months ago

9 months ago

9 months ago

9 months ago

9 months ago

0.0.0-vector-query-sources-20250516172905

6 months ago

0.7.0

7 months ago

0.9.4

6 months ago

0.9.3

6 months ago

0.0.0-pass-headers-for-create-mastra-client-20250529190531

5 months ago

8 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

0.0.0-redis-cloud-transporter-20250508191651

6 months ago

8 months ago

7 months ago

8 months ago

8 months ago

5 months ago

8 months ago

8 months ago

7 months ago

8 months ago

7 months ago

8 months ago

7 months ago

8 months ago

7 months ago

8 months ago

8 months ago

8 months ago

0.0.0-vnextAgentNetwork-20250527111332

5 months ago

0.0.0-mastra-2973-fast-mcp-removal-20250409163028

7 months ago

0.10.0-alpha.1

5 months ago

0.0.0-separate-trace-data-from-component-20250501042644

6 months ago

0.9.3-alpha.0

6 months ago

0.0.0-vnextAgentNetwork-20250602134426

5 months ago

0.2.1-alpha.0

8 months ago

0.9.3-alpha.1

6 months ago

0.0.0-pass-headers-for-create-mastra-client-20250529200245

5 months ago

11 months ago

11 months ago

7 months ago

11 months ago

11 months ago

7 months ago

7 months ago

8 months ago

0.0.0-pass-headers-for-create-mastra-client-20250530010057

5 months ago

0.5.0

8 months ago

0.0.0-remove-cloud-span-transform-20250425214156

6 months ago

0.9.0-alpha.8

6 months ago

0.0.0-vnext-inngest-20250506123700

6 months ago

0.0.0-vnextWorkflows-20250422081019

6 months ago

0.0.0-vnext-inngest-20250508122351

6 months ago

7 months ago

11 months ago

7 months ago

11 months ago

7 months ago

11 months ago

0.0.0-vnext-inngest-20250508111904

6 months ago

7 months ago

11 months ago

7 months ago

11 months ago

11 months ago

0.0.0-vnextWorkflows-20250416071310

7 months ago

0.1.27-alpha.15

11 months ago

0.0.0-course-20250527170450

5 months ago

11 months ago

11 months ago

11 months ago

11 months ago

0.0.0-agui-20250501191909

6 months ago

0.0.0-expose-more-playground-ui-20250501175749

6 months ago

0.0.0-expose-more-playground-ui-20250502141824

6 months ago

7 months ago

7 months ago

7 months ago

7 months ago

11 months ago

7 months ago

11 months ago

0.0.0-vnextWorkflows-20250421054100

6 months ago

0.8.0-alpha.2

7 months ago

0.1.27-alpha.32

11 months ago

0.0.0-llamaindex-extract-20250416163822

7 months ago

7 months ago

11 months ago

7 months ago

7 months ago

11 months ago

11 months ago

11 months ago

11 months ago

0.0.0-vnext-inngest-20250508121018

6 months ago

0.1.27-alpha.28

11 months ago

0.0.0-mastra-3338-mastra-memory-pinecone-20250507174328

6 months ago

0.1.27-alpha.29

11 months ago

0.6.3

8 months ago

0.0.0-bundle-dynamic-imports-20250424001248

6 months ago

0.6.2

8 months ago

0.0.0-commonjs-20250227130920

8 months ago

7 months ago

8 months ago

8 months ago

5 months ago

5 months ago

5 months ago

5 months ago

0.0.0-afterToolExecute-20250415041527

7 months ago

0.0.0-vnextAgentNetwork-20250527091247

5 months ago

8 months ago

8 months ago

11 months ago

8 months ago

11 months ago

0.0.0-vnextAgentNetwork-20250602084555

5 months ago

0.1.27-alpha.42

11 months ago

0.10.2-alpha.5

5 months ago

0.0.0-vnextAgentNetwork-20250527105810

5 months ago

8 months ago

11 months ago

5 months ago

8 months ago

10 months ago

5 months ago

10 months ago

5 months ago

10 months ago

11 months ago

8 months ago

11 months ago

0.0.0-mastra-3171-llamaindex-pin-20250423175211

6 months ago

0.1.27-alpha.39

11 months ago

0.0.0-commonjs-20250414101718

7 months ago

0.0.0-mcp-server-deploy-20250507160341

6 months ago

0.9.5-alpha.0

6 months ago

0.0.0-switch-to-core-20250424015131

6 months ago

0.0.0-vnext-inngest-20250507093737

6 months ago

0.0.0-default-storage-virtual-file-20250410035748

7 months ago

0.0.0-vnextWorkflows-20250421062111

6 months ago

7 months ago

7 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

0.0.0-cli-debug-20250611094457

5 months ago

10 months ago

10 months ago

8 months ago

10 months ago

0.0.0-a2a-20250421213654

6 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

0.0.0-vector-sources-20250516175436

6 months ago

0.0.0-vnextWorkflows-20250422142014

6 months ago

0.1.27-alpha.60

10 months ago

0.1.27-alpha.61

10 months ago

0.1.27-alpha.62

10 months ago

0.0.0-vnextWorkflows-20250421113058

6 months ago

10 months ago

10 months ago

9 months ago

9 months ago

9 months ago

9 months ago

10 months ago

10 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

0.0.0-vnext-inngest-20250508110322

6 months ago

0.0.0-fix-memory-xxhash-20250409202110

7 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

9 months ago

12 months ago

9 months ago

12 months ago

9 months ago

0.0.0-expose-more-playground-ui-20250502050852

6 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

8 months ago

0.0.0-fix-message-embedding-20250506021742

6 months ago

0.0.0-afterToolExecute-20250414225911

7 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

9 months ago

0.0.0-pg-pool-options-20250428183821

6 months ago

0.0.0-mcp-server-update-parse-20250421171139

6 months ago

0.1.27-alpha.81

9 months ago

0.1.27-alpha.82

9 months ago

0.0.0-vnext-inngest-20250506121901

6 months ago

0.0.0-llamaindex-switch-core-20250424001624

6 months ago

0.10.4-alpha.2

5 months ago

0.0.0-revert-schema-20250416221206

7 months ago

0.10.4-alpha.3

5 months ago

0.10.4-alpha.0

5 months ago

0.10.4-alpha.1

5 months ago

0.0.0-trigger-playground-ui-package-20250506151043

6 months ago

0.0.0-cli-debug-2-20250611100354

5 months ago

0.8.1-alpha.0

7 months ago

0.5.1-alpha.0

8 months ago

0.0.0-message-ordering-20250415215612

7 months ago

0.0.0-vnext-inngest-20250508131921

6 months ago

0.0.0-vnextWorkflows-20250417075051

7 months ago

0.0.0-inject-middleware-20250528213451

5 months ago

12 months ago

12 months ago

11 months ago

12 months ago

0.0.0-vnextWorkflows-20250421125930

6 months ago

0.1.27-alpha.2

12 months ago

0.9.0

6 months ago

0.0.0-mcp-server-update-20250421162713

6 months ago

0.1.27-alpha.7

11 months ago

0.0.0-extend-clickhouse-20250418135620

7 months ago

0.0.0-remove-tiktoken-20250415231938

7 months ago

0.5.0-alpha.10

8 months ago

0.1.27-alpha.8

11 months ago

0.0.0-cloud-transporter-20250513033346

6 months ago

6 months ago

11 months ago

6 months ago

11 months ago

11 months ago

0.0.0-mcp-schema-serializer-20250430202337

6 months ago

0.10.1-alpha.0

5 months ago

0.0.0-inject-middleware-20250528222017

5 months ago

0.0.0-add-runtime-context-to-openai-realtime-20250516201052

6 months ago

0.4.3-alpha.0

8 months ago

0.10.1-alpha.1

5 months ago

0.4.3-alpha.1

8 months ago

0.0.0-separate-trace-data-from-component-20250501141108

6 months ago

0.10.1-alpha.3

5 months ago

0.9.4-alpha.2

6 months ago

0.0.0-redis-cloud-transporter-20250508203756

6 months ago

8 months ago

6 months ago

6 months ago

6 months ago

8 months ago

6 months ago

0.0.0-redis-cloud-transporter-20250508194049

6 months ago

0.0.0-vnextAgentNetwork-20250527102918

5 months ago

0.0.0-vnext-inngest-20250506132005

6 months ago

0.2.1

8 months ago

0.0.0-storage-20250225005900

8 months ago

0.2.0

9 months ago

0.0.0-agui-20250501182100

6 months ago

7 months ago

7 months ago

12 months ago

1 year ago

1 year ago

1 year ago

1 year ago

12 months ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago