Skip to content

Releases: Lusqinha/tralha

Release list

tralha 0.2.0

tralha 0.2.0 Latest
Latest

Choose a tag to compare

View all tags
@Lusqinha Lusqinha released this 29 Oct 18:33
v0.2.0
173f369

tralha can now be deployed on Easypanel in a few clicks.

Easypanel

In an Easypanel project, open Templates → Create from Schema and paste deploy/easypanel/schema.json. Easypanel builds tralha from master and serves it over HTTPS: the service domain gets the API, the MCP server and the admin panel, and files- plus the same domain gets the public links. Data lives in a volume at /data, and the container drops every Linux capability.

After the first build, create an admin key from the service console:

tralha key create admin --scope '*:admin'

The wiki has the details. The same definition is also in deploy/easypanel/template/, in the layout of the official Easypanel templates repository.

Fixes

  • CLI help and error messages that were still in Portuguese are now in English.

Upgrading from 0.1.0

The database schema did not change. Pull and rebuild:

git pull
docker compose up -d --build

Full list of changes in CHANGELOG.md.

Assets 2
Loading

tralha 0.1.0

tralha 0.1.0

Choose a tag to compare

View all tags
@Lusqinha Lusqinha released this 29 Oct 18:23
v0.1.0
5bc2a20

First public release of tralha: self-hosted storage for the files your AI agents produce, with revocable public links and an MCP server.

It replaces the throwaway branch that agents create to get GitHub URLs for PR screenshots. An agent uploads a file to a bucket, asks for a link and pastes the markdown into the PR. Notes and findings live in the same place and are searchable.

Highlights

  • Buckets with folder-like keys, scoped API keys and revocable links that never expire unless you set an expiry.
  • MCP server at /mcp, plus single-use upload URLs so binary files skip base64.
  • Web admin panel to browse, preview and upload files and manage links, buckets, cleanup rules and compression.
  • Image decoding in a sandboxed worker (resource limits, no process creation, Landlock), and a guard that rejects unauthenticated requests before reading their body.
  • Separate private and public ports, with an optional Caddy proxy that serves both over HTTPS on a VPS.

Get started

git clone https://github.com/Lusqinha/tralha.git && cd tralha
cp .env.example .env
docker compose up -d --build

See the README for connecting Claude Code and deploying on a VPS. The full list of changes is in CHANGELOG.md.

Known limits

Files are stored on local disk only, there are no database migrations yet, and ChatGPT connectors need OAuth, which is not supported yet.

Loading