hanguyen1907 commited on
Commit
12fc8d1
Β·
verified Β·
1 Parent(s): ef989c6

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +62 -9
README.md CHANGED
@@ -1,15 +1,68 @@
1
  ---
2
- title: Road Friend
3
- emoji: πŸ’¬
4
- colorFrom: yellow
5
- colorTo: purple
6
  sdk: gradio
7
- sdk_version: 5.42.0
8
  app_file: app.py
9
  pinned: false
10
- hf_oauth: true
11
- hf_oauth_scopes:
12
- - inference-api
13
  ---
14
 
15
- An example chatbot using [Gradio](https://gradio.app), [`huggingface_hub`](https://huggingface.co/docs/huggingface_hub/v0.22.2/en/index), and the [Hugging Face Inference API](https://huggingface.co/docs/api-inference/index).
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
  ---
2
+ title: Road Buddy - AI Driving Assistant
3
+ emoji: πŸš—
4
+ colorFrom: blue
5
+ colorTo: green
6
  sdk: gradio
7
+ sdk_version: 4.44.1
8
  app_file: app.py
9
  pinned: false
10
+ license: mit
11
+ suggested_hardware: a10g-small
 
12
  ---
13
 
14
+ # πŸš— Road Buddy - AI Driving Assistant
15
+
16
+ Your intelligent companion for safer driving! Road Buddy analyzes dashcam footage and provides real-time driving assistance.
17
+
18
+ ## Features
19
+
20
+ ### πŸ›£οΈ Road Description
21
+ Upload a dashcam video and get a detailed description of:
22
+ - Road conditions (traffic, weather, visibility)
23
+ - Vehicles and pedestrians nearby
24
+ - Traffic signs and signals
25
+ - Potential hazards
26
+
27
+ ### πŸ’¬ Chat with Buddy
28
+ Ask any question about the road scene:
29
+ - "Can I overtake here?"
30
+ - "What does that sign mean?"
31
+ - "Is it safe to turn?"
32
+ - "Should I slow down?"
33
+
34
+ ### πŸ“ Traffic Quiz
35
+ Answer multiple choice questions about traffic situations - great for learning and testing!
36
+
37
+ ### πŸ–ΌοΈ Image Analysis
38
+ Upload dashcam images and ask questions about them.
39
+
40
+ ### πŸ“· Real-time Analysis
41
+ Use your camera for real-time road analysis (best with dashcam-mounted device).
42
+
43
+ ## Model
44
+
45
+ - **Base Model:** [unsloth/Qwen3-VL-4B-Instruct](https://huggingface.co/unsloth/Qwen3-VL-4B-Instruct)
46
+ - **LoRA Adapter:** [hanguyen1907/Qwen3-4B-SFT](https://huggingface.co/hanguyen1907/Qwen3-4B-SFT)
47
+ - **Fine-tuned for:** Vietnamese Traffic Scenarios
48
+
49
+ ## Usage
50
+
51
+ 1. **Upload dashcam video** or use camera
52
+ 2. **Choose a mode:** Description, Chat, Quiz, or Real-time
53
+ 3. **Get AI-powered insights** about road conditions
54
+
55
+ ## Safety Notice ⚠️
56
+
57
+ - **Do not use while driving!** Have a passenger operate the device.
58
+ - This AI assistant is for informational purposes only.
59
+ - Always follow traffic rules and use your own judgment.
60
+
61
+ ## Hardware Requirements
62
+
63
+ - Recommended: GPU (A10G or equivalent)
64
+ - Minimum VRAM: 16GB
65
+
66
+ ## License
67
+
68
+ MIT