Jasmine Wong commited on
Commit
7e7bef7
Β·
1 Parent(s): 492b943

fix HF readme metadata

Browse files
Files changed (1) hide show
  1. README.md +19 -127
README.md CHANGED
@@ -1,3 +1,12 @@
 
 
 
 
 
 
 
 
 
1
  # DriveCore πŸš—βš‘
2
 
3
  **An AI-powered incident response, forensic analysis, and branch debugging platform for autonomous vehicle fleets.**
@@ -11,7 +20,6 @@ Quick Start Instructions to Run on AMD GPU Droplet:
11
  ollama serve &
12
 
13
  2) Start Qwen backend
14
- ->Go into Docker container first
15
  cd /app/Autopulse
16
  uvicorn backend:app --host 0.0.0.0 --port 8006 &
17
 
@@ -21,144 +29,28 @@ bun run dev --host 0.0.0.0 --port 30000 &
21
  4) Go to Website
22
  http://165.245.137.74:30000
23
 
24
-
25
  ## What is DriveCore?
26
 
27
  DriveCore routes every autonomous vehicle incident, near miss, and sensor log through a multi-step AI agent pipeline β€” surfacing root causes, compliance concerns, and operator coaching plans in seconds.
28
 
29
- When an AV has an incident (GNSS failure, unexpected stop, software regression), engineers spend hours manually triaging logs and writing reports. DriveCore automates that entire workflow using a 5-step LangChain agent pipeline powered by Qwen3 on AMD GPU.
30
-
31
- ---
32
-
33
- ## ✨ Features
34
-
35
- | Module | What it does |
36
- |---|---|
37
- | **Incident Analysis** | Submit text or file-based incident reports. Five AI agents intake, enrich, analyze root causes, generate response plans, and draft formal safety reports. |
38
- | **Branch Debug** | Paste a git diff or code snippet + failure description β†’ get ranked root-cause suspects with file path, line range, confidence, and mechanism. IP Shield strips secrets before anything reaches the AI. |
39
- | **Forensic Debrief** | Three-stage post-deployment forensic pipeline: code-only hypotheses β†’ log correlation β†’ full ROS bag / sensor data trace. |
40
- | **Compliance Concerns** | Aggregated view of all compliance flags across incidents, referenced to AV standards (NHTSA AV Policy, ISO 26262, SAE J3016, FMVSS, UN R157). |
41
- | **Coaching Recommendations** | Operator and engineer action items surfaced from all completed analyses. |
42
- | **Safety Reports** | Browse and export completed incident analyses as Markdown reports. |
43
-
44
- ---
45
-
46
  ## πŸ€– AI Agent Pipeline
47
 
48
- DriveCore uses a **5-step LangChain agentic workflow** powered by **Qwen3 on AMD Instinct GPU**:
49
-
50
- ```
51
- Step 1: Intake Agent β†’ Classifies incident, extracts vehicle ID, timestamp, severity (P1/P2/P3)
52
- Step 2: Enrichment Agent β†’ Identifies affected AV subsystems (GNSS, LiDAR, perception, planning, control)
53
- Step 3: Risk Agent β†’ Root cause analysis ranked by confidence (ISO 26262, SAE J3016, NHTSA)
54
- Step 4: Response Agent β†’ Immediate actions, short-term fixes, long-term prevention measures
55
  Step 5: Documentation Agent β†’ Formal Markdown safety report + Qwen's Personal Recommendation
56
- ```
57
-
58
- Each step feeds into the next, forming a genuine multi-agent reasoning chain β€” not just a single LLM call.
59
-
60
- ---
61
 
62
  ## πŸ— Tech Stack
63
 
64
- | Layer | Technology |
65
- |---|---|
66
- | **AI Model** | Qwen3 (open-source) via Ollama |
67
- | **Agent Framework** | LangChain (multi-step agentic pipeline) |
68
- | **GPU Compute** | AMD Instinct MI300X via AMD Developer Cloud |
69
- | **Backend** | FastAPI (Python), OpenAI-compatible API |
70
- | **Frontend** | React 19 + TanStack Start + Vite + Tailwind CSS v4 |
71
- | **Database** | Supabase (Postgres + Auth) |
72
- | **Deployment** | AMD Developer Cloud (GPU backend) |
73
-
74
- ---
75
-
76
- ## πŸš€ Quick Start
77
-
78
- ### Prerequisites
79
- - AMD Developer Cloud account with GPU droplet
80
- - Docker
81
- - Ollama
82
- - Bun β‰₯ 1.0
83
-
84
- ### 1. Clone the repo
85
- ```bash
86
- git clone https://github.com/nextgenframes/DriveCore.git
87
- cd DriveCore
88
- ```
89
-
90
- ### 2. Install dependencies
91
- ```bash
92
- bun install
93
- ```
94
-
95
- ### 3. Set up environment variables
96
- ```bash
97
- cp .env.example .env
98
- ```
99
-
100
- Edit `.env`:
101
- ```
102
- VITE_SUPABASE_URL=your_supabase_url
103
- VITE_SUPABASE_PUBLISHABLE_KEY=your_anon_key
104
- SUPABASE_SERVICE_ROLE_KEY=your_service_role_key
105
- AI_BASE_URL=http://your_amd_gpu_ip:8006
106
- AI_API_KEY=dummy
107
- AI_MODEL=qwen3
108
- ```
109
-
110
- ### 4. Start the Qwen3 backend on AMD GPU
111
- ```bash
112
- # Inside your AMD GPU container
113
- ollama serve &
114
- ollama pull qwen3
115
- pip install langchain langchain-ollama fastapi uvicorn
116
- uvicorn backend:app --host 0.0.0.0 --port 8006 &
117
- ```
118
-
119
- ### 5. Run the frontend
120
- ```bash
121
- bun run dev --host 0.0.0.0 --port 30000
122
- ```
123
-
124
- ---
125
-
126
- ## πŸ”Œ API Endpoints
127
-
128
- | Endpoint | Method | Description |
129
- |---|---|---|
130
- | `/health` | GET | Health check β€” confirms Qwen3 is running |
131
- | `/triage` | POST | Full 5-step agentic incident triage pipeline |
132
- | `/branch-debug` | POST | Git diff root cause analysis |
133
- | `/forensic` | POST | Forensic content analysis |
134
- | `/v1/chat/completions` | POST | OpenAI-compatible endpoint |
135
-
136
- ---
137
-
138
- ## πŸ” Security
139
-
140
- - **IP Shield** β€” Branch Debug strips API keys, JWTs, and secrets before sending to AI
141
- - **SSRF Guard** β€” Forensic pipeline blocks loopback, private, and cloud metadata IPs
142
- - **Auth** β€” Supabase authentication with row-level security
143
-
144
- ---
145
 
146
  ## πŸ† Hackathon
147
 
148
- Built for **AMD Developer Cloud Hackathon β€” Track 1: AI Agents & Agentic Workflows**
149
-
150
- - βœ… LangChain multi-step agentic pipeline
151
- - βœ… Qwen3 open-source model
152
- - βœ… Running on AMD Instinct GPU via AMD Developer Cloud
153
- - βœ… Real AV safety use case (incident triage, branch debug, forensic analysis)
154
- - βœ… OpenAI-compatible API
155
-
156
- ---
157
-
158
- ## πŸ“œ License
159
-
160
- Proprietary β€” internal use only unless otherwise specified.
161
-
162
- ---
163
 
164
  *Powered by AMD Instinct GPU ⚑*
 
1
+ ---
2
+ title: DriveCore
3
+ emoji: πŸš—
4
+ colorFrom: indigo
5
+ colorTo: purple
6
+ sdk: docker
7
+ pinned: false
8
+ ---
9
+
10
  # DriveCore πŸš—βš‘
11
 
12
  **An AI-powered incident response, forensic analysis, and branch debugging platform for autonomous vehicle fleets.**
 
20
  ollama serve &
21
 
22
  2) Start Qwen backend
 
23
  cd /app/Autopulse
24
  uvicorn backend:app --host 0.0.0.0 --port 8006 &
25
 
 
29
  4) Go to Website
30
  http://165.245.137.74:30000
31
 
 
32
  ## What is DriveCore?
33
 
34
  DriveCore routes every autonomous vehicle incident, near miss, and sensor log through a multi-step AI agent pipeline β€” surfacing root causes, compliance concerns, and operator coaching plans in seconds.
35
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
36
  ## πŸ€– AI Agent Pipeline
37
 
38
+ Step 1: Intake Agent β†’ Classifies incident, extracts vehicle ID, timestamp, severity
39
+ Step 2: Enrichment Agent β†’ Identifies affected AV subsystems
40
+ Step 3: Risk Agent β†’ Root cause analysis ranked by confidence
41
+ Step 4: Response Agent β†’ Immediate actions, short-term fixes, long-term prevention
 
 
 
42
  Step 5: Documentation Agent β†’ Formal Markdown safety report + Qwen's Personal Recommendation
 
 
 
 
 
43
 
44
  ## πŸ— Tech Stack
45
 
46
+ - AI Model: Qwen3 via Ollama
47
+ - Agent Framework: LangChain
48
+ - GPU Compute: AMD Instinct MI300X via AMD Developer Cloud
49
+ - Backend: FastAPI (Python)
50
+ - Frontend: React 19 + TanStack Start + Vite + Tailwind CSS v4
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
51
 
52
  ## πŸ† Hackathon
53
 
54
+ Built for AMD Developer Cloud Hackathon β€” Track 1: AI Agents & Agentic Workflows
 
 
 
 
 
 
 
 
 
 
 
 
 
 
55
 
56
  *Powered by AMD Instinct GPU ⚑*