Skip to main content

brainsless-connect

Seals your repo's .env values and hands them to Brainsless so it can boot your app in a sandbox. The values are encrypted on your machine first; only ciphertext goes over the wire.

uvx brainsless-connect <url from the Brainsless screen>

The URL is single-use and expires in 30 minutes. It points at the vault, the only service that can decrypt what you send.

What it does

Finds the .env files in your repo (including ones inside a monorepo), shows you every var it found and where it came from, and asks before sending. When you confirm, it AES-256-GCM encrypts the values under a fresh key, wraps that key with RSA against the vault's public key, and POSTs the ciphertext. Nothing readable crosses the wire, so a TLS terminator or an access log has nothing to catch.

What it won't send

  • DATABASE_URL, POSTGRES*, REDIS*, MONGO*, MYSQL*, AMQP_URL, KAFKA*, the sandbox makes its own.
  • Anything with sk_live_, pk_live_, rk_live_, no moving real money from a test run.
  • NODE_ENV, PORT, HOST, and the rest of the runtime, the sandbox sets those.

These are dropped before anything is encrypted. Their names get reported so the screen knows a refusal happened, but the values never leave your machine.

Running it without a prompt

With no terminal and no --yes, it prints what it would send and stops, so a script or an agent gets a list to show a person instead of sending silently. Add --yes to seal without the prompt, once someone who owns the secrets has seen the list.

Reading it first

One module, standard library plus cryptography (the audited AES-GCM and RSA-OAEP implementation). Pin a version and read exactly what you'll run:

pip download brainsless-connect==2.0.0 --no-deps --no-binary :all:

The source is at github.com/brainsless/vault under python/.

Metadata

Release files for brainsless-connect 2.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for brainsless-connect 2.0.0
File Size Uploaded
brainsless_connect-2.0.0.tar.gz 5.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for brainsless-connect 2.0.0
File Interpreter ABI Platform
brainsless_connect-2.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 10.8 kB

Release files / brainsless_connect-2.0.0.tar.gz

Download URL brainsless_connect-2.0.0.tar.gz
Size 5.0 kB
Tags Source
SHA-256 checksum
How to use checksums
f9ef2b55e4a194c5ec01e147653b167d1e1761236982c3577c066cafd5f3cd80
BLAKE2b-256 checksum
How to use checksums
6c89a114475cbf9af757c4d158b4d56eb64c43e705db2534725df086bcbe496a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / brainsless_connect-2.0.0-py3-none-any.whl

Download URL brainsless_connect-2.0.0-py3-none-any.whl
Size 5.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f34b17f19d9defc37de04393c873c28aeecae5cf86ab522a013511de5a9138af
BLAKE2b-256 checksum
How to use checksums
bb754974e87057dbf84ca42de2a703eb9570184979d703942703105fcb9895f2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

This release

2.0.0 This release

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page