Spaces:
Running
Running
| title: CyberForge | |
| emoji: 🐢 | |
| colorFrom: purple | |
| colorTo: indigo | |
| sdk: streamlit | |
| sdk_version: 1.44.1 | |
| app_file: app.py | |
| pinned: false | |
| license: apache-2.0 | |
| # CyberForge Dashboard | |
| A comprehensive dark web intelligence platform for monitoring, analyzing, and visualizing potential threats and data breaches. | |
| ## Features | |
| ### Core Functionality | |
| - Dark web content monitoring and scraping | |
| - Threat intelligence dashboard with visualization | |
| - Indicator of compromise (IOC) tracking | |
| - Alerting system for detected threats | |
| - Reporting and analytics | |
| ### Enhanced Security Features | |
| - **OSINT Integration:** Correlates dark web data with intelligence from VirusTotal and AlienVault OTX | |
| - **API Security:** JWT tokens, API keys, rate limiting, and role-based access controls | |
| - **Data Privacy:** PII detection and masking to protect sensitive information | |
| ## Technical Stack | |
| - **Backend:** FastAPI, SQLAlchemy, Async PostgreSQL | |
| - **Frontend:** Streamlit | |
| - **Database:** PostgreSQL | |
| - **Integration:** Support for external OSINT feeds and Tor proxying | |
| - **Security:** JWT authentication, API key management, data masking | |
| ## Getting Started | |
| ### Prerequisites | |
| - Python 3.9+ | |
| - PostgreSQL | |
| ### Installation | |
| 1. Clone the repository: | |
| ```bash | |
| git clone https://github.com/yourusername/cyberforge-dashboard.git | |
| cd cyberforge-dashboard | |
| ``` | |
| 2. Install dependencies: | |
| ```bash | |
| pip install -r requirements_hf.txt | |
| ``` | |
| 3. Set up environment variables: | |
| ``` | |
| DATABASE_URL=postgresql://user:password@localhost/cyberforge | |
| JWT_SECRET_KEY=your_secret_key | |
| ``` | |
| 4. Run the application: | |
| ```bash | |
| streamlit run app.py | |
| ``` | |
| ### Deployment to Hugging Face Spaces | |
| This project is configured for automatic deployment to Hugging Face Spaces using GitHub Actions. | |
| #### Setup Instructions: | |
| 1. Create a new Hugging Face Space: | |
| - Go to [Hugging Face Spaces](https://huggingface.co/spaces) | |
| - Click "Create Space" | |
| - Select "Streamlit" as the SDK | |
| - Fill in the space name and other details | |
| 2. Add the following secrets to your GitHub repository: | |
| - `HF_TOKEN`: Your Hugging Face API token (from [Hugging Face settings](https://huggingface.co/settings/tokens)) | |
| - `HF_USERNAME`: Your Hugging Face username | |
| - `HF_SPACE_NAME`: The name of your Hugging Face Space | |
| 3. Push to your GitHub repository's main branch, and the GitHub Actions workflow will automatically deploy to your Hugging Face Space. | |
| The deployment process copies the necessary files (with Hugging Face-specific configurations) to your Space, ensuring the application runs in demo mode on Hugging Face. | |
| ## API Documentation | |
| The API provides endpoints for: | |
| - Authentication and user management | |
| - Threat intelligence submission and retrieval | |
| - Dark web content scraping and analysis | |
| - Alerts and notifications | |
| API documentation is available at `/docs` when running the API server. | |
| ## License | |
| This project is licensed under the MIT License - see the LICENSE file for details. | |
| --- | |
| Built with ❤️ by [Canstralian] |