Csplk commited on
Commit
a88c530
·
verified ·
1 Parent(s): 2434571

Upload folder using huggingface_hub

Browse files
Files changed (2) hide show
  1. docs/PROJECT.md +35 -0
  2. 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