What is Stashy?
Stashy is a self-hosted file storage service built for AI agents. Upload files, share when ready — that’s it.Key Features
Pluggable Storage
Memory, local disk, Google Cloud Storage, or any S3-compatible backend.
Flexible Database
SQLite out of the box. Postgres when you need a separate database.
Multi-Protocol
One port serves REST, gRPC, Connect, and gRPC-Web.
Single Binary
One Go binary, zero external dependencies.
Shareable Links
Every file gets a permanent URL, with an optional slug and private, internal, or public visibility.
MCP
AI assistants can list, share, upload, and download your files.
How It Works
1
Sign in and get an API key
Visit the dashboard (
/), sign in with Google, and generate an API key.2
Create a file
POST /v1/files?visibility=public with your Bearer token. Choose private (only you), internal (any signed-in user, the default), or public (anyone). You get back the file with its id and a direct url.3
Share the link
Send the
url — it works right away for whoever the visibility allows. Change it anytime with PATCH /v1/files/{id}.Quick Links
Quickstart
Get running in under 5 minutes
API Reference
Upload and download files