Welcome to dbcreds¶

dbcreds

Professional Database Credentials Management

Get Started → View Documentation

🔐 Secure by Design¶

🛡️ Multiple Storage Backends

Leverage your system's native credential store - Windows Credential Manager, macOS Keychain, or Linux Secret Service.

🔑 Never Plain Text

Credentials are encrypted at rest using industry-standard encryption. Your passwords never touch disk in plain text.

🔄 Password Rotation Tracking

Built-in password expiry tracking with notifications. Never forget to rotate credentials again.

⚡ Quick Start¶

# Install dbcreds
pip install git+https://github.com/Sunnova-ShakesDlamini/dbcreds.git

# Initialize and add your first environment
dbcreds init
dbcreds add dev --type postgresql

# Use in your Python code
from dbcreds import get_engine
engine = get_engine("dev")

🎯 Key Features¶

🌍 Multi-Environment

Manage credentials for development, staging, and production environments with ease.

🚀 Rich CLI

Beautiful command-line interface built with Rich and Typer for a delightful developer experience.

🌐 Web Interface

Optional FastAPI web interface for team collaboration and visual credential management.

📊 Multi-Database

Support for PostgreSQL, MySQL, Oracle, SQL Server, and more.

🐍 Python First

Seamless integration with SQLAlchemy, pandas, and async frameworks.

📝 Type Safe

Full type hints with Pydantic models for reliable, maintainable code.

📚 Documentation¶

Quickstart Guide - Get up and running in 5 minutes
CLI Reference - Complete command-line documentation
Python API - Use dbcreds in your Python applications
Web Interface - Set up the team collaboration interface
API Reference - Detailed API documentation

🔧 Installation¶

pipuvDevelopment

pip install git+https://github.com/Sunnova-ShakesDlamini/dbcreds.git

uv pip install git+https://github.com/Sunnova-ShakesDlamini/dbcreds.git

git clone https://github.com/Sunnova-ShakesDlamini/dbcreds.git
cd dbcreds
uv venv
uv pip install -e ".[dev]"

💡 Why dbcreds?¶

Stop hardcoding credentials

No more passwords in code, environment files, or notebooks. dbcreds provides a secure, centralized way to manage database credentials across all your projects.

Built for teams

With the web interface, team members can securely share access to development and staging databases without sharing passwords directly.

Production ready

Used in production environments with support for password rotation policies, audit logging, and enterprise security requirements.

Made with 💚 by Sunnova ShakesDlamini