haydenbleasel/files-sdk
A unified storage SDK for object and blob backends. One small, honest API. Web-standards I/O. observed · 2026-08-28
Health v2 · maintenance only
80/100
- Activity 97
- Release rhythm 98
- Longevity 8
Flags: young
How is this computed?
round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10) — computed 2026-09-02. Adoption (stars, forks) is never an input.
- gap_med: 4
- age_days: 117
- days_rel: 19
- days_push: 19
- n_releases_24m: 20
Adoption not part of the score
1515 stars · 46 forks observed · 2026-08-28
What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded
Files SDK is a unified TypeScript storage SDK that provides one small API (ten methods) across 40+ object and blob storage providers including S3, R2, GCS, Azure, Vercel Blob, and Supabase. It ships with an agent-friendly CLI, a built-in MCP server, and Vercel AI SDK tools for letting AI agents browse and mutate buckets.
Use cases
- upload files to s3 without learning the aws sdk
- switch storage providers without rewriting call sites
- support multiple blob storage backends with one api
- generate presigned upload urls for direct browser uploads
- let an ai agent list and manage files in a bucket
- mirror or sync objects between two storage backends
- search large buckets with glob patterns
- script storage operations from the command line with output
When to choose
- you want provider-agnostic object storage code that works across S3, R2, GCS, Azure, Vercel Blob, and S3-compatible services
- you need normalized errors and one call shape instead of per-provider SDK quirks
- you are building AI agents that need file storage tools with approval gating
- you want a CLI or MCP server for storage operations
When to avoid
- you need deep provider-specific features like S3 versioning, lifecycle rules, or multipart as first-class API (only available via the raw escape hatch)
- you only ever target a single provider and prefer its official SDK
- you need block or file-system storage rather than object/blob storage
Facets
library · maturity active
sdk file-system object-storage cli mcp http-client developer-tools files cloud-computing backend apis bun cross-platform cli object-storage blob-storage s3 cloudflare-r2 vercel-blob storage-abstraction multi-provider presigned-urls agent-tools ai-agents nodejs deno typescript
10 sources
- readme: https://github.com/haydenbleasel/files-sdk · fetched 2026-08-28 · 9a3e476f4d90
- homepage: https://files-sdk.dev/ · fetched 2026-08-29 · 0a2f5e295826
- site_page: https://files-sdk.dev/docs · fetched 2026-08-29 · 83719abaf252
- site_page: https://files-sdk.dev/docs/adapters · fetched 2026-08-29 · 8a0a9643b15b
- site_page: https://files-sdk.dev/docs/api · fetched 2026-08-29 · cdf51317ac11
- site_page: https://files-sdk.dev/docs/api/search · fetched 2026-08-29 · 092aead028cc
- site_page: https://files-sdk.dev/docs/ai/vercel · fetched 2026-08-29 · 4937c1babf57
- site_page: https://files-sdk.dev/docs/cli · fetched 2026-08-29 · 11b9807bbb7f
- registry_npm: https://registry.npmjs.org/files-sdk · fetched 2026-08-29 · f3758968d9e0
- site_page: https://files-sdk.dev/changelog/files-sdk-2-3-0 · fetched 2026-08-29 · c13edcb5ebc3
Member repositories
| Repository | Role | Health v2 |
|---|---|---|
| haydenbleasel/files-sdk | main | 80 |
For agents
markdown · JSON · MCP: product_card(name="haydenbleasel/files-sdk")
Data as of 2026-08-30T08:39:29.467469+00:00 · Report a problem