Hugging Face's logo

Spaces:
BaseerAI
/
Baseer_Server
Running

App Files Community
altawil commited on
Commit
adff7c4
·
verified ·
1 Parent(s): 7b0dd2f

Update README.md

Browse files

Deploy Baseer Self-Driving API v1.0

Files changed (1) hide show
  1. README.md +142 -7
README.md CHANGED
@@ -1,12 +1,147 @@
1
  ---
2
- title: Baseer Server
3
- emoji: 📈
4
- colorFrom: purple
5
- colorTo: purple
6
  sdk: docker
 
7
  pinned: false
8
- license: apache-2.0
9
- short_description: self-driving
 
 
 
 
 
 
 
 
 
 
10
  ---
11
 
12
- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
  ---
2
+ title: Baseer Self-Driving API
3
+ emoji: 🚗
4
+ colorFrom: blue
5
+ colorTo: green
6
  sdk: docker
7
+ app_port: 7860
8
  pinned: false
9
+ license: mit
10
+ short_description: Self-driving API using InterFuser model
11
+ tags:
12
+ - computer-vision
13
+ - autonomous-driving
14
+ - deep-learning
15
+ - fastapi
16
+ - pytorch
17
+ - interfuser
18
+ - graduation-project
19
+ - carla
20
+ - self-driving
21
  ---
22
 
23
+ # 🚗 Baseer Self-Driving API
24
+
25
+ [![Hugging Face Spaces](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Spaces-blue)](https://huggingface.co/spaces/Adam-IT/Baseer_Server)
26
+ [![FastAPI](https://img.shields.io/badge/FastAPI-005571?style=flat&logo=fastapi)](https://fastapi.tiangolo.com/)
27
+ [![PyTorch](https://img.shields.io/badge/PyTorch-%23EE4C2C.svg?style=flat&logo=PyTorch&logoColor=white)](https://pytorch.org/)
28
+
29
+ ## 📋 وصف المشروع
30
+
31
+ **Baseer** هو نظام قيادة ذاتية متقدم يستخدم نموذج **InterFuser** المدرب على بيانات محاكاة CARLA. يوفر هذا المشروع واجهة برمجة تطبيقات (API) قوية ومستضافة على Hugging Face Spaces للتفاعل مع نموذج القيادة الذاتية.
32
+
33
+ ## ✨ الميزات الرئيسية
34
+
35
+ ### 🧠 **نموذج InterFuser متقدم**
36
+ - مدرب على بيانات PDM_Lite_Carla
37
+ - يركز على اكتشاف الكائنات المرورية (Traffic Detection)
38
+ - دقة عالية في تحديد المسارات (Waypoint Prediction)
39
+ - تحليل متقدم للمشهد البصري
40
+
41
+ ### 🏗️ **بنية خادم-عميل**
42
+ - **FastAPI** للأداء العالي
43
+ - معالجة متوازية للطلبات
44
+ - إدارة جلسات متعددة
45
+ - واجهة RESTful سهلة الاستخدام
46
+
47
+ ### 📊 **مخرجات شاملة**
48
+ - **أوامر التحكم**: انعطاف، تسارع، فرملة
49
+ - **خريطة المرور**: اكتشاف المركبات والمشاة
50
+ - **تحليل المشهد**: إشارات المرور، علامات التوقف، التقاطعات
51
+ - **لوحة معلومات**: صورة تفاعلية شاملة
52
+
53
+ ## 🚀 كيفية الاستخدام
54
+
55
+ ### 1. بدء جلسة جديدة
56
+ ```bash
57
+ curl -X POST "https://adam-it-baseer-server.hf.space/start_session"
58
+ ```
59
+
60
+ ### 2. إرسال إطار للمعالجة
61
+ ```bash
62
+ curl -X POST "https://adam-it-baseer-server.hf.space/run_step" \
63
+ -H "Content-Type: application/json" \
64
+ -d '{
65
+ "session_id": "your-session-id",
66
+ "image_b64": "base64-encoded-image",
67
+ "measurements": {
68
+ "pos": [0.0, 0.0],
69
+ "theta": 0.0,
70
+ "speed": 0.0,
71
+ "command": 4
72
+ }
73
+ }'
74
+ ```
75
+
76
+ ### 3. إنهاء الجلسة
77
+ ```bash
78
+ curl -X POST "https://adam-it-baseer-server.hf.space/end_session?session_id=your-session-id"
79
+ ```
80
+
81
+ ## 📡 نقاط النهاية (API Endpoints)
82
+
83
+ | النقطة | الطريقة | الوصف |
84
+ |--------|---------|--------|
85
+ | `/` | GET | معلومات الـ API |
86
+ | `/start_session` | POST | بدء جلسة جديدة |
87
+ | `/run_step` | POST | معالجة إطار واحد |
88
+ | `/end_session` | POST | إنهاء جلسة |
89
+ | `/sessions` | GET | عرض الجلسات النشطة |
90
+ | `/docs` | GET | توثيق تفاعلي للـ API |
91
+
92
+ ## 🔧 المواصفات التقنية
93
+
94
+ ### النموذج
95
+ - **النوع**: InterFuser (Fine-tuned)
96
+ - **Backbone**: ResNet-50 للصور
97
+ - **البعد المدمج**: 256
98
+ - **طبقات المحول**: 6 encoder + 6 decoder
99
+ - **حجم النموذج**: 545 MB
100
+
101
+ ### المدخلات
102
+ - **الصور**: 224x224 RGB
103
+ - **القياسات**: الموقع، السرعة، الاتجاه
104
+ - **الأوامر**: أوامر القيادة عالية المستوى
105
+
106
+ ### المخرجات
107
+ - **أوامر التحكم**: steer, throttle, brake
108
+ - **خريطة المرور**: شبكة 20x20 للكائنات
109
+ - **المسارات**: 10 نقاط مستقبلية
110
+ - **تحليل المشهد**: junction, traffic_light, stop_sign
111
+
112
+ ## 🎯 حالات الاستخدام المثلى
113
+
114
+ - ✅ **القيادة في الطرق المستقيمة**
115
+ - ✅ **اكتشاف المركبات والمشاة**
116
+ - ✅ **تجنب العوائق**
117
+ - ✅ **التنبؤ بالمسارات**
118
+ - ✅ **تحليل المشهد المروري**
119
+
120
+ ## ⚠️ القيود
121
+
122
+ - محدود بكاميرا أمامية واحدة
123
+ - لا يستخدم بيانات LiDAR
124
+ - مُحسن للبيئات المحاكاة (CARLA)
125
+ - قد يحتاج تعديل للبيئات الحقيقية
126
+
127
+ ## 🛠️ التطوير والمساهمة
128
+
129
+ هذا المشروع جزء من مشروع تخرج في مجال الذكاء الاصطناعي والقيادة الذاتية. تم تطويره باستخدام:
130
+
131
+ - **PyTorch** للتعلم العميق
132
+ - **FastAPI** لواجهة البرمجة
133
+ - **OpenCV** لمعالجة الصور
134
+ - **NumPy** للحوسبة العلمية
135
+
136
+ ## 📞 التواصل والدعم
137
+
138
+ للاستفسارات والدعم التقني، يرجى استخدام:
139
+ - **Issues** في مستودع GitHub
140
+ - **Community** في Hugging Face
141
+ - **Discussions** في صفحة Space
142
+
143
+ ---
144
+
145
+ **تم تطويره بواسطة**: Adam-IT
146
+ **الترخيص**: MIT
147
+ **النسخة**: 1.0.0