{"id":25511260,"url":"https://github.com/cluena/cipherbox","last_synced_at":"2026-05-03T05:37:01.873Z","repository":{"id":278159929,"uuid":"934695606","full_name":"clueNA/CipherBox","owner":"clueNA","description":"Secure file encryption system using RSA and AES hybrid encryption. Built with Python and Streamlit.","archived":false,"fork":false,"pushed_at":"2025-02-18T09:35:55.000Z","size":40,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-18T10:37:31.618Z","etag":null,"topics":["python","streamlit"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/clueNA.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-18T09:02:12.000Z","updated_at":"2025-02-18T09:35:59.000Z","dependencies_parsed_at":"2025-02-18T10:47:36.599Z","dependency_job_id":null,"html_url":"https://github.com/clueNA/CipherBox","commit_stats":null,"previous_names":["cluena/cipherbox"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clueNA%2FCipherBox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clueNA%2FCipherBox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clueNA%2FCipherBox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clueNA%2FCipherBox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/clueNA","download_url":"https://codeload.github.com/clueNA/CipherBox/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239639746,"owners_count":19672889,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["python","streamlit"],"created_at":"2025-02-19T10:30:26.269Z","updated_at":"2025-11-27T07:30:16.883Z","avatar_url":"https://github.com/clueNA.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![CipherBox](https://socialify.git.ci/clueNA/CipherBox/image?font=Source+Code+Pro\u0026language=1\u0026name=1\u0026owner=1\u0026pattern=Transparent\u0026stargazers=1\u0026theme=Dark)\n# CipherBox 🔒\n\nCipherBox is a secure file encryption system that uses RSA and AES hybrid encryption to protect your files. Built with Python and Streamlit, it provides a user-friendly interface for file encryption and decryption while maintaining high security standards.\n\n## 🌐 Live Demo\n[![Streamlit App](https://static.streamlit.io/badges/streamlit_badge_black_white.svg)](https://cipherbox.streamlit.app/)\n\n\n## Features\n\n### 🛡️ Security\n- Hybrid encryption (RSA + AES) for optimal security and performance\n- Unique encryption keys for each user\n- Secure password hashing with salt\n- Protected private keys\n- Session-based authentication\n\n### 📁 File Management\n- Support for all file types\n- File size limit: 10MB (configurable)\n- Encrypted file tracking\n- Secure file storage\n- Multi-user support\n\n### 🎯 Key Features\n- User registration and authentication\n- File encryption with personal keys\n- File decryption for authorized users\n- File history tracking\n- Data clearing option\n\n## Installation\n\n### Prerequisites\n```bash\n- Python 3.8 or higher\n- pip (Python package manager)\n```\n\n### Setup\n1. Clone the repository:\n```bash\ngit clone https://github.com/clueNA/cipherbox.git\ncd cipherbox\n```\n\n2. Install required packages:\n```bash\npip install -r requirements.txt\n```\n\n3. Initialize the database:\n```bash\npython create_database.py\n```\n\n4. Run the application:\n```bash\nstreamlit run app.py\n```\n\n## Usage\n\n### 👤 User Management\n\n1. **Registration**\n   - Click the \"Register\" tab\n   - Enter username and password\n   - System generates encryption keys automatically\n\n2. **Login**\n   - Use the \"Login\" tab\n   - Enter credentials\n   - Access your encrypted files\n\n### 🔒 File Encryption\n\n1. Select \"Encrypt File\" tab\n2. Upload file (up to 100MB)\n3. Click \"Encrypt\"\n4. Download encrypted file (*.encrypted)\n\n### 🔓 File Decryption\n\n1. Select \"Decrypt File\" tab\n2. Upload encrypted file (*.encrypted)\n3. Click \"Decrypt\"\n4. Download original file\n\n### 📋 File Management\n\n- View all encrypted files in \"File List\" tab\n- Track encryption dates\n- Manage file access\n\n## Technical Details\n\n### Security Implementation\n\n```python\n# Encryption Process\n- RSA 2048-bit key pair generation\n- AES-256 for file encryption\n- PBKDF2 for password hashing\n- Secure random salt generation\n```\n\n### Database Structure\n\n- Users Table\n  - Username\n  - Password hash\n  - Public/Private keys\n  - Salt\n\n- FileKeys Table\n  - Filename\n  - File hash\n  - Encrypted key\n  - Owner reference\n\n## File Support\n\n### Supported File Types\n- Documents (.pdf, .doc, .txt, etc.)\n- Images (.jpg, .png, .gif, etc.)\n- Media files (.mp3, .mp4, etc.)\n- Archives (.zip, .rar, etc.)\n- Any other file type\n\n### Size Limitations\n- Default: 100MB\n- Configurable in config.py\n\n## Security Considerations\n\n### Best Practices\n- Keep encrypted files backed up\n- Store passwords securely\n- Don't share private keys\n- Log out after usage\n- Regular password updates\n\n### Data Protection\n- Files encrypted with personal keys\n- Only file owner can decrypt\n- Secure key storage\n- Protected user sessions\n\n## Troubleshooting\n\n### Common Issues\n\n1. **Registration Fails**\n   - Check username availability\n   - Ensure password meets requirements\n\n2. **Encryption Fails**\n   - Verify file size limits\n   - Check file permissions\n\n3. **Decryption Fails**\n   - Confirm file ownership\n   - Verify correct user login\n   - Check file integrity\n\n## Contributing\n\n1. Fork the repository\n2. Create feature branch\n3. Commit changes\n4. Push to branch\n5. Create Pull Request\n\n## License\n\nApache-2.0 license - See LICENSE file for details\n\n## Contact\n\n- GitHub Issues: [Create Issue](https://github.com/clueNA/cipherbox/issues)\n\n## Acknowledgments\n\n- Streamlit for the web interface\n- cryptography.io for encryption\n- SQLAlchemy for database management\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcluena%2Fcipherbox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcluena%2Fcipherbox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcluena%2Fcipherbox/lists"}