Files
Turn a local file into a link a tool can read.
Providers read photos, recordings and documents from public links. supe makes those links for you.
Pass a local file
Any parameter named *_url, *_urls, images or files takes a local path. supe uploads the file first (up to 20 MB) and sends the link:
supe fal#bria_background_remove --body image_url=./photo.pngurl works too when the value looks like a path, like ./page.html.
Upload once, use many times
supe upload ./photo.png # prints the file's link
supe upload https://example.com/report.pdf # stores a copy of a link that may expire
supe files # files in this workspace, with their links
supe files photo.png # just that oneAnyone with a file's link can read it.
Get a file from a person
When your user has the file and you don't:
supe upload --link contract.pdfThis prints a one-time page. Give the link to the person; they upload the file there. Then check for it with supe files contract.pdf.
Over HTTP and MCP
- HTTP:
POST /v1/fileswith{"name"}returns a one-timeupload_urltoPUTthe file to; with{"url"}it stores a copy of that link.GET /v1/files?name=lists them. - MCP:
add_fileandlist_files.