Skip to content

lbx - Lock Box

A lightweight secret storage vault with CLI and Python API. Stores secrets in encrypted files with master password secured via OS keychain.

What is lbx?

lbx provides secure, encrypted storage for sensitive data like API keys, passwords, and configuration secrets. It features both a command-line interface and Python API for seamless integration into your workflow.

Key Features

  • Secure Encryption: AES-256 encryption with master password protection
  • Cross-Platform: Works on Windows, macOS, and Linux
  • Dual Interface: Both CLI and Python API available
  • Keychain Integration: Master password stored securely in OS keychain
  • Simple Workflow: Intuitive commands for daily use
  • Minimal Dependencies: Lightweight and secure

Getting Started

  • Installation

    Install lbx using pipx, pip, or from source

    Install lbx

  • Quick Start

    Get up and running with lbx in minutes

    Quick start guide

  • CLI Reference

    Complete command-line interface documentation

    CLI commands

  • API Reference

    Python API for programmatic access

    Python API

Use Cases

Development Teams
Store API keys, database credentials, and service tokens securely across team members
DevOps & CI/CD
Manage secrets in deployment pipelines and infrastructure automation
Personal Projects
Keep sensitive configuration data encrypted and organized
Security-Conscious Users
Replace plain-text config files with encrypted secret storage

Why lbx?

Feature lbx Environment Variables Config Files
Encryption ✅ AES-256 ❌ Plain text ❌ Plain text
Cross-platform ✅ Windows/Mac/Linux ✅ All platforms ✅ All platforms
Keychain integration ✅ OS keychain ❌ Manual ❌ Manual
Programmatic access ✅ CLI + Python API ✅ Environment ✅ File parsing
Version control safe ✅ Encrypted files ❌ Exposed secrets ❌ Exposed secrets

Requirements

  • Python 3.10 or higher
  • Windows, macOS, or Linux
  • OS keychain support (automatic)

Community & Support

License

lbx is released under the MIT License.

Ready to secure your secrets? Start with the Installation Guide or jump to the Quick Start.

© 2025 Jitesh Sahani (JD)
📧 jitesh.sahani@outlook.com

"Your secrets are safe, your mind at peace."
🐺 Crafted by a dreamer, for dreamers 🐺