@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 freestyle-sandboxes examples-create-workflow examples-tool-as-workflow-step examples-calling-agent-from-workflow examples-calling-llm-from-workflow calling-agent-from-workflow calling-llm-from-workflow saket-mastra @t-care/mastra @laomeifun/closx @aios-labs/mastra @alanagoyal/mcp-server @apofasi-core/mastra @dnax/ai @cogito.ai/voice-openai @codists/mcp-test @codists/mcp-test-weather @diffusionstudio/dapi @serverless/ai @mseep/mastra-playwright-mcp @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/vector-upstash @mastra/vector-vectorize @mastra/vercel @mastra/x @mastra/xero @mastra/zendesk @mastra/zoom @mastra/admin @mastra/apollo @mastra/asana @mastra/ashby @mastra/attio @mastra/brex @mastra/claude @mastra/clickup @mastra/client-js @mastra/coda @mastra/mailchimp @mastra/mcp-weather-server @mastra/notion @mastra/openai @mastra/oura @mastra/dane @mastra/discord @mastra/docusign @mastra/dropbox @mastra/elevenlabs @mastra/engine @mastra/resend @mastra/rewatch @mastra/salesforce @mastra/salesloft @mastra/sendgrid @mastra/shopify @mastra/slack @mastra/figma @mastra/gong @mastra/google @mastra/google_ads @mastra/google_calendar @mastra/google_docs @mastra/google_drive @mastra/google_mail @mastra/google_sheet @mastra/greenhouse @mastra/gusto @mastra/hubspot @mastra/instagram @mastra/intercom @mastra/jira @mastra/lever @mastra/composio @mastra/pinterest @mastra/quickbooks

8 months ago

8 months ago

10 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

11 months ago

11 months ago

11 months ago

8 months ago

11 months ago

11 months ago

11 months ago

11 months ago

0.0.0-mastra-3123-mcp-server-20250419180157

8 months ago

0.10.6-alpha.0

6 months ago

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

8 months ago

0.2.0-alpha.100

10 months ago

0.2.0-alpha.101

10 months ago

0.2.0-alpha.102

10 months ago

0.0.0-taofeeqInngest-20250603090617

7 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

1 year ago

1 year ago

0.0.0-generate-message-id-20250512171942

8 months ago

10 months ago

10 months ago

10 months ago

10 months ago

0.0.0-vector-query-sources-20250516172905

7 months ago

0.7.0

9 months ago

0.9.4

7 months ago

0.9.3

8 months ago

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

7 months ago

10 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

0.0.0-redis-cloud-transporter-20250508191651

8 months ago

10 months ago

9 months ago

10 months ago

10 months ago

7 months ago

10 months ago

9 months ago

9 months ago

10 months ago

9 months ago

10 months ago

8 months ago

10 months ago

9 months ago

10 months ago

10 months ago

10 months ago

0.0.0-vnextAgentNetwork-20250527111332

7 months ago

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

9 months ago

0.10.0-alpha.1

7 months ago

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

8 months ago

0.9.3-alpha.0

8 months ago

0.0.0-vnextAgentNetwork-20250602134426

7 months ago

0.2.1-alpha.0

10 months ago

0.9.3-alpha.1

8 months ago

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

7 months ago

1 year ago

1 year ago

9 months ago

1 year ago

1 year ago

9 months ago

9 months ago

9 months ago

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

7 months ago

0.5.0

10 months ago

0.0.0-remove-cloud-span-transform-20250425214156

8 months ago

0.9.0-alpha.8

8 months ago

0.0.0-vnext-inngest-20250506123700

8 months ago

0.0.0-vnextWorkflows-20250422081019

8 months ago

0.0.0-vnext-inngest-20250508122351

8 months ago

8 months ago

1 year ago

8 months ago

1 year ago

8 months ago

1 year ago

0.0.0-vnext-inngest-20250508111904

8 months ago

8 months ago

1 year ago

8 months ago

1 year ago

1 year ago

0.0.0-vnextWorkflows-20250416071310

8 months ago

0.1.27-alpha.15

1 year ago

0.0.0-course-20250527170450

7 months ago

1 year ago

1 year ago

1 year ago

1 year ago

0.0.0-agui-20250501191909

8 months ago

0.0.0-expose-more-playground-ui-20250501175749

8 months ago

0.0.0-expose-more-playground-ui-20250502141824

8 months ago

9 months ago

9 months ago

9 months ago

9 months ago

1 year ago

9 months ago

1 year ago

0.0.0-vnextWorkflows-20250421054100

8 months ago

0.8.0-alpha.2

9 months ago

0.1.27-alpha.32

1 year ago

0.0.0-llamaindex-extract-20250416163822

8 months ago

9 months ago

1 year ago

9 months ago

9 months ago

1 year ago

1 year ago

1 year ago

1 year ago

0.0.0-vnext-inngest-20250508121018

8 months ago

0.1.27-alpha.28

1 year ago

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

8 months ago

0.1.27-alpha.29

1 year ago

0.6.3

9 months ago

0.0.0-bundle-dynamic-imports-20250424001248

8 months ago

0.6.2

9 months ago

0.0.0-commonjs-20250227130920

10 months ago

9 months ago

9 months ago

10 months ago

7 months ago

7 months ago

7 months ago

7 months ago

0.0.0-afterToolExecute-20250415041527

8 months ago

0.0.0-vnextAgentNetwork-20250527091247

7 months ago

10 months ago

10 months ago

1 year ago

10 months ago

1 year ago

0.0.0-vnextAgentNetwork-20250602084555

7 months ago

0.1.27-alpha.42

1 year ago

0.10.2-alpha.5

7 months ago

0.0.0-vnextAgentNetwork-20250527105810

7 months ago

10 months ago

1 year ago

7 months ago

9 months ago

1 year ago

7 months ago

12 months ago

7 months ago

12 months ago

1 year ago

9 months ago

1 year ago

0.0.0-mastra-3171-llamaindex-pin-20250423175211

8 months ago

0.1.27-alpha.39

1 year ago

0.0.0-commonjs-20250414101718

8 months ago

0.0.0-mcp-server-deploy-20250507160341

8 months ago

0.9.5-alpha.0

7 months ago

0.0.0-switch-to-core-20250424015131

8 months ago

0.0.0-vnext-inngest-20250507093737

8 months ago

0.0.0-default-storage-virtual-file-20250410035748

9 months ago

0.0.0-vnextWorkflows-20250421062111

8 months ago

9 months ago

9 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

0.0.0-cli-debug-20250611094457

7 months ago

12 months ago

12 months ago

10 months ago

12 months ago

0.0.0-a2a-20250421213654

8 months ago

8 months ago

8 months ago

9 months ago

9 months ago

9 months ago

9 months ago

0.0.0-vector-sources-20250516175436

7 months ago

0.0.0-vnextWorkflows-20250422142014

8 months ago

0.1.27-alpha.60

11 months ago

0.1.27-alpha.61

11 months ago

0.1.27-alpha.62

11 months ago

0.0.0-vnextWorkflows-20250421113058

8 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

12 months ago

11 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

0.0.0-vnext-inngest-20250508110322

8 months ago

0.0.0-fix-memory-xxhash-20250409202110

9 months ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

11 months ago

1 year ago

11 months ago

1 year ago

11 months ago

0.0.0-expose-more-playground-ui-20250502050852

8 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

10 months ago

0.0.0-fix-message-embedding-20250506021742

8 months ago

0.0.0-afterToolExecute-20250414225911

8 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

11 months ago

0.0.0-pg-pool-options-20250428183821

8 months ago

0.0.0-mcp-server-update-parse-20250421171139

8 months ago

0.1.27-alpha.81

11 months ago

0.1.27-alpha.82

11 months ago

0.0.0-vnext-inngest-20250506121901

8 months ago

0.0.0-llamaindex-switch-core-20250424001624

8 months ago

0.10.4-alpha.2

7 months ago

0.0.0-revert-schema-20250416221206

8 months ago

0.10.4-alpha.3

7 months ago

0.10.4-alpha.0

7 months ago

0.10.4-alpha.1

7 months ago

0.0.0-trigger-playground-ui-package-20250506151043

8 months ago

0.0.0-cli-debug-2-20250611100354

7 months ago

0.8.1-alpha.0

9 months ago

0.5.1-alpha.0

10 months ago

0.0.0-message-ordering-20250415215612

8 months ago

0.0.0-vnext-inngest-20250508131921

8 months ago

0.0.0-vnextWorkflows-20250417075051

8 months ago

0.0.0-inject-middleware-20250528213451

7 months ago

1 year ago

1 year ago

1 year ago

1 year ago

0.0.0-vnextWorkflows-20250421125930

8 months ago

0.1.27-alpha.2

1 year ago

0.9.0

8 months ago

0.0.0-mcp-server-update-20250421162713

8 months ago

0.1.27-alpha.7

1 year ago

0.0.0-extend-clickhouse-20250418135620

8 months ago

0.0.0-remove-tiktoken-20250415231938

8 months ago

0.5.0-alpha.10

10 months ago

0.1.27-alpha.8

1 year ago

0.0.0-cloud-transporter-20250513033346

8 months ago

8 months ago

1 year ago

8 months ago

1 year ago

1 year ago

0.0.0-mcp-schema-serializer-20250430202337

8 months ago

0.10.1-alpha.0

7 months ago

0.0.0-inject-middleware-20250528222017

7 months ago

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

7 months ago

0.4.3-alpha.0

10 months ago

0.10.1-alpha.1

7 months ago

0.4.3-alpha.1

10 months ago

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

8 months ago

0.10.1-alpha.3

7 months ago

0.9.4-alpha.2

8 months ago

0.0.0-redis-cloud-transporter-20250508203756

8 months ago

10 months ago

8 months ago

8 months ago

8 months ago

10 months ago

7 months ago

0.0.0-redis-cloud-transporter-20250508194049

8 months ago

0.0.0-vnextAgentNetwork-20250527102918

7 months ago

0.0.0-vnext-inngest-20250506132005

8 months ago

0.2.1

10 months ago

0.0.0-storage-20250225005900

10 months ago

0.2.0

10 months ago

0.0.0-agui-20250501182100

8 months ago

8 months ago

8 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

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago