CyberSafe is a versatile, all-in-one desktop platform for cybersecurity professionals, malware analysts, and security enthusiasts. Built with modern technologies, it provides essential tools for file analysis, malware detection, and security research in an intuitive interface.
- Features
- Installation
- Development Setup
- Usage
- Project Status
- Contributing
- Security
- Tech Stack
- License
- Support
- Owner
Calculate and verify file integrity using multiple cryptographic algorithms including MD5, SHA-1, SHA-256, SHA-512, and BLAKE3. Perfect for malware analysis and forensic investigations.
Comprehensive support for various encoding formats:
- Base64
- URL encoding/decoding
- HTML entity encoding
- Hexadecimal conversion
- Binary conversion
Integrated YARA rule engine for:
- Malware detection and classification
- Custom rule creation and testing
- File and process scanning
- Suspicious pattern identification
Advanced entropy calculation for:
- Identifying packed or encrypted content
- Detecting obfuscated malware
- Analyzing file randomness
- Cryptographic analysis
Extract human-readable strings from binary files:
- ASCII and Unicode string detection
- Configurable minimum string length
- Export results to various formats
- Metadata extraction
Real-time file integrity monitoring:
- Directory monitoring for changes
- Automated hash verification
- Alert system for modifications
- Forensic timeline generation
- Network traffic analysis
- Memory dump analysis
- Cryptographic key analysis
- Automated report generation
Download the latest release for your platform from the GitHub Releases page.
Supported Platforms:
- Linux (Ubuntu 20.04+, Debian 11+)
Prerequisites:
- Python 3.13+
- Rust (latest stable)
- npm or yarn
- Git
Build Steps:
# Clone the repository
git clone https://github.com/danielscos/CyberSafe.git
cd CyberSafe
# Install Rust (if not already installed)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source ~/.cargo/env
# Install frontend dependencies
cd frontend
npm install
# Build the backend executable (includes Rust compilation)
cd ../backend
pip install -r requirements.txt
python build.py
# Build the frontend and create distributable
cd ../frontend
npm run build
npm run distThe executable will be created in frontend/dist/ directory.
- Node.js 18+
- Python 3.13+
- Rust (latest stable)
- Git
-
Clone and Setup:
git clone https://github.com/danielscos/CyberSafe.git cd CyberSafe -
Install Rust:
# Install Rust if not already installed curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh source ~/.cargo/env
-
Backend Setup:
cd backend pip install -r requirements.txt # Build the Rust library for development cd ../rustlib pip install maturin maturin develop --release cd ../backend
-
Frontend Setup:
cd frontend npm install
Run everything (recommended):
cd frontend
npm run dev:allRun components separately:
# Terminal 1 - Backend
cd frontend
npm run backend
# Terminal 2 - Frontend dev server
npm run dev
# Terminal 3 - Electron app
npm run dev:electronBuild for production:
cd frontend
npm run build # Build frontend + backend
npm run dist # Create distributable package- Launch CyberSafe
- Select the tool you need from the main interface
- Follow the on-screen instructions for each tool
- Navigate to "File Hashing" tool
- Select or drag-and-drop your file
- Choose hash algorithms (MD5, SHA-256, etc.)
- View results and export if needed
- Open "YARA Scanner" tool
- Load your YARA rules or use built-in ones
- Select target files or directories
- Review scan results and threat classifications
Current Version: v0.1.0-alpha Status: Active Development
- Project setup and architecture
- Basic Electron + React frontend
- FastAPI backend foundation
- File hashing implementation
- Basic encoding/decoding tools
- YARA rule integration
- Entropy calculator
- String extractor
- Live hash monitoring
- Advanced malware analysis
- Network traffic analysis
- Automated reporting
- Plugin system
We welcome contributions from the cybersecurity community!
📖 For detailed contribution guidelines, please read our CONTRIBUTING.md file.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- Follow existing code style and patterns
- Add tests for new features
- Update documentation as needed
- Ensure cross-platform compatibility
Please use the GitHub Issues page to report bugs or request features.
If you discover a security vulnerability, please send an email to [security@cybersafe.dev] instead of using the public issue tracker.
- Always verify file hashes from trusted sources
- Keep CyberSafe updated to the latest version
- Review YARA rules before execution
- Use in isolated environments for malware analysis
- Electron - Cross-platform desktop framework
- React 19 - UI framework
- Vite - Build tool and dev server
- Material-UI - Component library
- Framer Motion - Animations
- Python 3.13 - Core backend language
- FastAPI - High-performance API framework
- Uvicorn - ASGI server
- PyInstaller - Python executable packaging
This project is licensed under the MIT License - see the LICENSE file for details.
If you find CyberSafe useful, please consider supporting its development:
- ⭐ Star this repository to show your support
- 🍴 Fork and contribute with new features or bug fixes
- 📢 Share with your cybersecurity colleagues and friends
- 💬 Provide feedback through issues and discussions
- 📝 Write blog posts or tutorials about CyberSafe
This project is developed and maintained by danielscos.
- 🌐 Website: danielscos.github.io/about_me
- 🐙 GitHub: github.com/danielscos
- 💼 LinkedIn: Connect with me
CyberSafe - Empowering cybersecurity professionals with modern tools 🛡️
Built with ❤️ for the cybersecurity community