rocheston/zelen repository overview

# Pull the image
docker pull rocheston/zelen:latest

# Check version
docker run --rm rocheston/zelen:latest --version

# Launch the web playground at http://localhost:8888
docker run -p 8888:8888 rocheston/zelen:latest

docker run -d \
  --name zelen-playground \
  -p 8888:8888 \
  rocheston/zelen:latest

# Open http://localhost:8888 in your browser

alias zelen='docker run --rm -v $(pwd):/data -w /data rocheston/zelen:latest'

# Generate a key pair (PQ5 suite — ML-KEM-1024 + ML-DSA-87)
zelen keys generate --subject [email protected] --name "Alice" --out alice

# List key info
zelen keys inspect --key alice.zkey

# Inspect a public key
zelen keys inspect --key alice.zpub

# Encrypt a text message
zelen encrypt text \
  --recipient alice.zpub \
  --text "Hello, quantum world!" \
  --out message.zelen

# Encrypt a file
zelen encrypt file \
  --recipient alice.zpub \
  --input secret.pdf \
  --out secret.zelen

# Encrypt and sign
zelen encrypt text \
  --recipient alice.zpub \
  --text "Signed message" \
  --sign-key sender.zkey \
  --out signed.zelen

# Decrypt a message
zelen decrypt text \
  --key alice.zkey \
  --input message.zelen

# Decrypt a file
zelen decrypt file \
  --key alice.zkey \
  --input secret.zelen \
  --out recovered.pdf

# Decrypt with passphrase from env
ZELEN_PASS=mysecret zelen decrypt text \
  --key alice.zkey \
  --passphrase-env ZELEN_PASS \
  --input message.zelen

# Sign a file
zelen sign --key alice.zkey --input report.pdf --out report.sig

# Verify a signature
zelen verify --key alice.zpub --input report.pdf --sig report.sig

# Convert binary .zelen to ASCII armor (.asc)
zelen armor --input message.zelen --out message.zelen.asc

# Dearmor back to binary
zelen dearmor --input message.zelen.asc --out message.zelen

# View .zelen container header fields
zelen inspect --input message.zelen

# Run diagnostics
zelen doctor

# Run self-test suite
zelen self-test

# Run benchmarks
zelen bench

# Generate shell completions (bash/zsh/fish)
zelen completions bash > /etc/bash_completion.d/zelen

services:
  zelen:
    image: rocheston/zelen:latest
    ports:
      - "8888:8888"
    volumes:
      - ./keys:/home/zelen/keys
    restart: unless-stopped