Spaces:
No application file
No application file
Upload folder using huggingface_hub
Browse files- docs/PROJECT.md +35 -0
- requirements.txt +8 -0
docs/PROJECT.md
ADDED
|
@@ -0,0 +1,35 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# Mooncrime Project Documentation
|
| 2 |
+
|
| 3 |
+
## Project Overview
|
| 4 |
+
|
| 5 |
+
Mooncrime is a security research tool designed to analyze screenshots from Shodan, focusing on Industrial Control Systems (ICS) and RTSP camera streams. The tool utilizes the Moondream 3 Vision Language Model (VLM) to provide detailed security analysis of exposed systems.
|
| 6 |
+
|
| 7 |
+
## Goals and Objectives
|
| 8 |
+
|
| 9 |
+
### Primary Goals
|
| 10 |
+
1. **Security Vulnerability Assessment**: Identify and analyze exposed ICS interfaces and camera systems
|
| 11 |
+
2. **Research Tool Development**: Build a reproducible workflow for analyzing internet-connected device screenshots
|
| 12 |
+
3. **Community Education**: Provide a tool for security researchers to understand exposed system risks
|
| 13 |
+
|
| 14 |
+
### Secondary Goals
|
| 15 |
+
1. Document common vulnerability patterns in exposed systems
|
| 16 |
+
2. Develop best practices for secure system configuration
|
| 17 |
+
3. Support academic and professional security research
|
| 18 |
+
|
| 19 |
+
## Technical Architecture
|
| 20 |
+
|
| 21 |
+
### Components
|
| 22 |
+
- **Moondream 3 Model**: Vision Language Model for image analysis
|
| 23 |
+
- **Daggr Framework**: Workflow orchestration and UI generation
|
| 24 |
+
- **Gradio Interface**: User interface for image input and results display
|
| 25 |
+
- **Hugging Face Spaces**: Deployment platform for ZeroGPU inference
|
| 26 |
+
|
| 27 |
+
### Data Flow
|
| 28 |
+
1. User provides Shodan screenshot URL or uploads image
|
| 29 |
+
2. Image is preprocessed and prepared for analysis
|
| 30 |
+
3. Moondream 3 model generates analysis based on prompts
|
| 31 |
+
4. Results are formatted and displayed to user
|
| 32 |
+
|
| 33 |
+
## Shodan Query Reference
|
| 34 |
+
|
| 35 |
+
### Industrial Control Systems
|
requirements.txt
ADDED
|
@@ -0,0 +1,8 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
daggr>=0.5.4
|
| 2 |
+
gradio>=6.0.2
|
| 3 |
+
pydantic>=2.10.0
|
| 4 |
+
requests>=2.32.0
|
| 5 |
+
huggingface-hub>=0.27.0
|
| 6 |
+
transformers>=4.49.0
|
| 7 |
+
torch>=2.5.0
|
| 8 |
+
accelerate>=0.35.0
|