semvec/pypi-packages huggingface dataset:
seamm-exec 2025.10.23
Classes to execute background codes for SEAMM
License: MIT
Requires Python: >=3.8

SEAMM exec
==============================
[//]: # (Badges)
[![GitHub Actions Build Status](https://github.com/molssi-seamm/seamm_exec/workflows/CI/badge.svg)](https://github.com/molssi-seamm/seamm_exec/actions?query=workflow%3ACI)
[![codecov](https://codecov.io/gh/molssi-seamm/SEAMM exec/branch/main/graph/badge.svg)](https://codecov.io/gh/molssi-seamm/SEAMM exec/branch/main)


Classes to execute background codes for SEAMM

### Copyright

Copyright (c) 2023, Paul Saxe


#### Acknowledgements
 
Project based on the 
[Computational Molecular Science Python Cookiecutter](https://github.com/molssi/cookiecutter-cms) version 1.1.
keypass-cli 0.1.0
keypass — minimal secure CLI demo (test only)
License: MIT
Requires Python: >=3.9
Keywords: cli, security, encryption, mongodb, credentials

# keypass — minimal secure CLI demo (test only)

This is a small demo CLI you can install locally and use to test encrypted storage with MongoDB.

**NOT production-ready.** Intended for quick testing.

## 🚀 Quick Start for Users

### Step 1: Install
```bash
pip install keypass-secure-cli
```

### Step 2: Initialize & Use (Zero Setup!)
```bash
keypass init
keypass add-cred github_token
keypass get-cred github_token
keypass delete-cred github_token
```

### 🔑 Master Key Management (Multi-PC Access)
```bash
# Export master key to use on other PCs
keypass export-master-key my-key.txt

# Import master key on another PC
keypass import-master-key my-key.txt

# Complete backup (credentials + master key)
keypass backup-cred my-backup.json

# Restore everything on another PC
keypass restore-cred my-backup.json
```

**That's it!** The app automatically connects to our secure cloud database.

### 🔧 Advanced Setup (Optional)

**Use Your Own Atlas Database:**
```bash
export MONGO_ATLAS_USER="your_username"
export MONGO_ATLAS_PASS="your_password"
export MONGO_ATLAS_CLUSTER="your_cluster_name"
```

**Use Local MongoDB:**
```bash
brew install mongodb-community  # macOS
brew services start mongodb-community
```

### 🎯 Quick Setup Script
```bash
# Run the interactive setup script
./quick_setup.sh
```

## Warnings & next steps

This demo stores secrets in MongoDB encrypted with a symmetric key stored in your OS keyring. For production:

- Use KMS (AWS KMS / GCP KMS / HashiCorp Vault) or a secure HSM.
- Add authentication and audit logging.
- Rotate keys, protect logs, and never print secrets in plain text.