창조 마스트라
독립형 Mastra 프로젝트를 만듭니다. 기본적으로create-mastra기본 스타터를 설치하고 선택한 Model 공급자에 맞게 구성합니다.
- npm
- pnpm
- Yarn
- Bun
npx create-mastra@latest
pnpm dlx create-mastra@latest
yarn dlx create-mastra@latest
bun x create-mastra@latest
생성 모드생성 모드에 대한 직접 링크
기본 스타터기본 스타터에 대한 직접 링크
기본 스타터는 작업 공간 Tool, Memory, 작업 추적, 웹 액세스, 반복 일정, 저장 및 Observability을 갖춘 Agent 하네스를 생성합니다. OpenAI, Anthropic, Gemini 또는 xAI를 Model 공급자로 선택하세요.
Prompt 없이 프로젝트를 생성하려면 프로젝트 이름과 Provider를 모두 제공하세요. 이 예제에서는 Anthropic을 사용합니다. openai, google 또는 xai를 전달할 수도 있습니다.
- npm
- pnpm
- Yarn
- Bun
npx create-mastra@latest my-mastra-project --llm anthropic
pnpm dlx create-mastra@latest my-mastra-project --llm anthropic
yarn dlx create-mastra@latest my-mastra-project --llm anthropic
bun x create-mastra@latest my-mastra-project --llm anthropic
Provider를 선택하고 선택적으로 API 키를 대화형으로 입력하려면 --llm을 생략하세요. 대화형 설정에서는 프로젝트를 Mastra 플랫폼에 연결하는 옵션도 제공합니다. 활성화하면 명령이 브라우저 인증 흐름을 열고 로컬 프로젝트와 같은 이름으로 플랫폼 프로젝트를 생성합니다. 그런 다음 MASTRA_PLATFORM_ACCESS_TOKEN과 MASTRA_PROJECT_ID를 .env에 기록합니다.
주형주형에 대한 직접 링크
템플릿 슬러그 또는 공개 GitHub URL을 사용하세요.
- npm
- pnpm
- Yarn
- Bun
npx create-mastra@latest my-mastra-project --template agent-harness
pnpm dlx create-mastra@latest my-mastra-project --template agent-harness
yarn dlx create-mastra@latest my-mastra-project --template agent-harness
bun x create-mastra@latest my-mastra-project --template agent-harness
- npm
- pnpm
- Yarn
- Bun
npx create-mastra@latest my-mastra-project --template https://github.com/mastra-ai/template-agent-harness
pnpm dlx create-mastra@latest my-mastra-project --template https://github.com/mastra-ai/template-agent-harness
yarn dlx create-mastra@latest my-mastra-project --template https://github.com/mastra-ai/template-agent-harness
bun x create-mastra@latest my-mastra-project --template https://github.com/mastra-ai/template-agent-harness
대화형으로 템플릿을 선택하려면 템플릿 값을 비워 두세요.
- npm
- pnpm
- Yarn
- Bun
npx create-mastra@latest my-mastra-project --template
pnpm dlx create-mastra@latest my-mastra-project --template
yarn dlx create-mastra@latest my-mastra-project --template
bun x create-mastra@latest my-mastra-project --template
템플릿 작성자는 자체 종속성, Model, 환경 변수, 소스 코드를 관리합니다. create-mastra는 --llm 또는 --llm-api-key를 적용하지 않습니다.
빈 비계빈 비계에 대한 직접 링크
Agent, 예제, Model SDK, 환경 파일이 없는 최소 Provider 비종속 프로젝트를 생성하려면 --empty를 사용하세요.
- npm
- pnpm
- Yarn
- Bun
npx create-mastra@latest my-empty-project --empty
pnpm dlx create-mastra@latest my-empty-project --empty
yarn dlx create-mastra@latest my-empty-project --empty
bun x create-mastra@latest my-empty-project --empty
자동 설정자동 설정에 대한 직접 링크
종속성을 설치한 후 명령은 다음과 같습니다.
PATH에서 지원되는 코딩 도우미를 감지하고 Mastra Skill을 설치합니다. 감지되지 않으면 범용 Skill을 설치합니다.- 현재 디렉터리와 생성된 프로젝트가 아직 Git 리포지토리 안에 없으면 초기 Git 커밋을 생성합니다.
이 단계를 건너뛰려면
--no-skills또는--no-git을 사용하세요. Skill 및 Git 설정 실패 시 경고가 표시되지만 성공적으로 생성된 프로젝트는 제거되지 않습니다.
충돌 및 검증충돌 및 검증에 대한 직접 링크
--empty와--template은 함께 사용할 수 없습니다.--llm과--llm-api-key는 기본 스타터 프로젝트에서만 유효합니다.- 프로젝트 이름은 안전한 소문자 단일 디렉터리 이름이어야 하며 대상이 이미 존재해서는 안 됩니다. 템플릿을 가져오거나 파일을 생성하기 전에 잘못된 입력이 거부됩니다.
인수 및 플래그인수 및 플래그에 대한 직접 링크
[project-name]?:
--empty?:
-l, --llm <provider>?:
-k, --llm-api-key <key>?:
--no-skills?:
--no-git?:
--no-install?:
-t, --template [template]?:
--timeout <milliseconds>?:
--version?:
--help?:
원격 측정원격 측정에 대한 직접 링크
Mastra는 운영 체제, Mastra 버전, Node.js 버전 등 익명의 CLI 사용 정보를 수집합니다. 다음을 검토할 수 있습니다.analytics source.
옵트아웃하려면 MASTRA_TELEMETRY_DISABLED=1을 설정하세요.
MASTRA_TELEMETRY_DISABLED=1 npx create-mastra@latest my-project --empty