vellaris 0.1.5

End-to-end encrypted document sharing you self-host.

                    _ _            _
       __   _____| | | __ _ _ __(_)___
       \ \ / / _ \ | |/ _` | '__| / __|
        \ V /  __/ | | (_| | |  | \__ \
         \_/ \___|_|_|\__,_|_|  |_|___/

Files only the people you choose can read.

End-to-end encrypted document sharing you self-host.

pip install vellaris

Source · PyPI · Docs · License

---

Status

v0.1.0 — first shippable release. Alpha; expect rough edges. The on-wire format is locked, so blobs encrypted with this release keep decrypting on later versions.

How it works

Vellaris encrypts files on your device with a fresh AES-256 key, then encrypts that key once for each recipient with their RSA-4096 public key. Your self-hosted server only ever holds ciphertext, encrypted-DEK rows, and a signed audit log — it cannot decrypt anything.

crypto: AES-256-GCM · RSA-4096 OAEP-SHA256 · Argon2id passphrase KDF

Three clients, one trust boundary

Client	Install	When to reach for it
CLI	pip install vellaris	Engineers, scripts, CI pipelines
Python SDK	pip install vellaris	Automations, ETLs, webhook handlers
Web	Static SPA, deploy-anywhere	Colleagues who don't live in a terminal

Every client speaks the same on-wire protocol; the server publishes its contract at /openapi.json.

Run a server

docker run -p 8000:8000 ghcr.io/subhayu99/vellaris:latest

Or docker compose -f docker/compose.yaml up for a Postgres-backed dev stack.

License

Apache 2.0. No CLA traps. Read every line on GitHub.