salman555 commited on
Commit
0e5ede4
Β·
verified Β·
1 Parent(s): b343da2

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +83 -1
README.md CHANGED
@@ -10,4 +10,86 @@ pinned: false
10
  license: mit
11
  ---
12
 
13
- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
10
  license: mit
11
  ---
12
 
13
+ # Drowsiness Detection
14
+
15
+ Sistem deteksi pengemudi mengantuk berbasis pengolahan citra dengan MediaPipe FaceMesh dan Gradio.
16
+ Alarm akan aktif jika mata tertutup lebih dari 3 detik.
17
+
18
+ ## Fitur
19
+
20
+ * Deteksi wajah dan landmark mata (Eye Aspect Ratio).
21
+ * Alarm suara dan notifikasi visual saat pengantukan.
22
+ * Antarmuka web lokal via Gradio.
23
+
24
+ ## Prasyarat
25
+
26
+ * Python 3.8+
27
+ * Conda atau pip environment
28
+ * Webcam terhubung
29
+
30
+ ## Instalasi
31
+
32
+ 1. Clone repository:
33
+
34
+ ```bash
35
+ git clone https://github.com/username/drowsiness_detection.git
36
+ cd drowsiness_detection
37
+ ```
38
+ 2. Buat environment Conda:
39
+
40
+ ```bash
41
+ conda create -n drowsy python=3.10
42
+ conda activate drowsy
43
+ ```
44
+ 3. Instal dependensi:
45
+
46
+ ```bash
47
+ pip install -r requirements.txt
48
+ conda install -c conda-forge simpleaudio
49
+ ```
50
+ 4. Letakkan file `alarm.wav` di direktori root proyek.
51
+
52
+ ## Struktur Proyek
53
+
54
+ ```
55
+ β”œβ”€β”€ app.py # Kode utama deteksi dan antarmuka Gradio
56
+ β”œβ”€β”€ requirements.txt # Daftar Python package
57
+ β”œβ”€β”€ README.md # Dokumentasi ini
58
+ β”œβ”€β”€ alarm.wav # File suara alarm
59
+ └── .gitignore # File/folder yang diabaikan Git
60
+ ```
61
+
62
+ ## Cara Menjalankan
63
+
64
+ ```bash
65
+ python app.py
66
+ ```
67
+
68
+ Buka browser ke `http://localhost:7860` dan ijinkan akses webcam.
69
+
70
+ ## License
71
+
72
+ ```
73
+ MIT License
74
+
75
+ Copyright (c) 2025 Salman Alfarisi
76
+
77
+ Permission is hereby granted, free of charge, to any person obtaining a copy
78
+ of this software and associated documentation files (the "Software"), to deal
79
+ in the Software without restriction, including without limitation the rights
80
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
81
+ copies of the Software, and to permit persons to whom the Software is
82
+ furnished to do so, subject to the following conditions:
83
+
84
+ The above copyright notice and this permission notice shall be included in all
85
+ copies or substantial portions of the Software.
86
+
87
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
88
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
89
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
90
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
91
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
92
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
93
+ SOFTWARE.
94
+ ```
95
+