0
Fork 0
mirror of https://github.com/mastra-ai/mastra.git synced 2026-11-17 08:44:46 +00:00
mastra/workspaces/gcs
dane-ai-mastra[bot] a5859ee2b9
chore: version packages (alpha) (#30430)
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
History 2026-11-16 14:09:31 +01:00
..
src feat(e2b): run commands as another OS user, and choose the owner of S3/GCS mounts (#30433) 2026-11-15 08:51:28 -08:00
.env.example feat: E2B sandbox and S3 filesystem with mount support (COR-380, COR-385, COR-484) (#12605) 2026-02-10 14:07:57 -08:00
.gitignore feat: E2B sandbox and S3 filesystem with mount support (COR-380, COR-385, COR-484) (#12605) 2026-02-10 14:07:57 -08:00
CHANGELOG.md chore: version packages (alpha) (#30430) 2026-11-16 14:09:31 +01:00
docker-compose.yml feat: E2B sandbox and S3 filesystem with mount support (COR-380, COR-385, COR-484) (#12605) 2026-02-10 14:07:57 -08:00
lint-staged.config.js refactor(lint): replace ESLint with type-aware oxlint (#27476) 2026-10-18 10:38:35 -07:00
package.json chore: version packages (alpha) (#30430) 2026-11-16 14:09:31 +01:00
README.md chore(*): Update/unify/add READMEs (#22858) 2026-09-02 14:36:59 +02:00
tsconfig.build.json feat: E2B sandbox and S3 filesystem with mount support (COR-380, COR-385, COR-484) (#12605) 2026-02-10 14:07:57 -08:00
tsconfig.json chore: migrate package builds to tsdown (#19829) 2026-07-28 12:32:21 +02:00
tsdown.config.ts chore: migrate package builds to tsdown (#19829) 2026-07-28 12:32:21 +02:00
vitest.config.ts feat: E2B sandbox and S3 filesystem with mount support (COR-380, COR-385, COR-484) (#12605) 2026-02-10 14:07:57 -08:00

@mastra/gcs

@mastra/gcs mounts a Google Cloud Storage bucket as the filesystem for a Mastra workspace. Use it when agents need durable, shared file access across processes or deployments instead of a local filesystem.

Installation

npm install @mastra/gcs

Usage

import { Agent } from '@mastra/core/agent';
import { Workspace } from '@mastra/core/workspace';
import { GCSFilesystem } from '@mastra/gcs';

const workspace = new Workspace({
  filesystem: new GCSFilesystem({
    bucket: 'my-gcs-bucket',
    // Uses Application Default Credentials by default
    // Or provide a service account key:
    projectId: 'my-project-id',
    credentials: JSON.parse(process.env.GCS_SERVICE_ACCOUNT_KEY),
  }),
});

const agent = new Agent({
  name: 'my-agent',
  model: 'anthropic/claude-opus-4-5',
  workspace,
});

Documentation

Changelog

See the package changelog for version history and release notes.

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.