hackathon_detail.md

### Project Overview

For this second hackathon, we decided to have fun and created an AI agent that connects directly to your car and helps you diagnose issues.

For this project, we have done:

- AI agent and chatbot to perform car diagnostics
- Diagnostic MCP server, which we installed directly on an OBD-II device.

> There is an OBD-II port in most cars that lets a diagnostic device communicate with the car’s computer. Mechanics attach their scanner to this port to read car health information and find out why warning lights are on.

<table><tr>
<td><img src="/gradio_api/file=assets/obd.png" alt="OBD-II dongle" width="200"></td>
<td><img src="/gradio_api/file=assets/agent.png" alt="Gradio Agent screenshot" width="200"></td>
</tr></table>

Above is the OBD-II dongle, which we used, we had to open it to replace the firmware with our special hackathon firmware ☺️

This demo on HuggingFace space is connecting to an OBD-II _simulator_ (we don’t want everyone to mess with our car :-). Fun fact, the simulator is also a Gradio space: [OBD-II Simulator Gradio space](https://huggingface.co/spaces/castlebbs/elm327-simulator)

If you want more details on how we implemented the MCP Server on the diagnostic device, navigate to the “MCP Server on embedded device” tab.

> Check our participation to the previous event: [In-game AI Generation of 3D environments](https://huggingface.co/spaces/Agents-MCP-Hackathon/3D-Game-Environment-Builder).

#### Team

- @stargarnet: AI agent
- @castlebbs: MCP server

#### AI credits Sponsor

- Nebius Token Factory

#### Technology used for the AI agent

- Gradio 6
- Langchain/Langgraph agent
- Tools used by the agent:
  - MCP Server providing functions to access the vehicle (MCP Server embedded in an OBD-II dongle or OBD-II Simulator)
    - System status
    - Send ELM327 and OBD-II requests
    - Obtain history of collected OBD-II PIDs
  - Tools to decode OBD-II responses
  - Hexadecimal tools
  - VIN decoding tool using the NHTSA API
  - YouTube videos search tool (doesn't seem to work on HuggingFace space)

#### Source code

- [MCP Server running on OBD-II device](https://huggingface.co/spaces/MCP-1st-Birthday/Vehicle-Diagnostic-Assistant/tree/main/MCP_servers/W600-embedded-OBD2)
- [Gradio Vehicle Diagnostic Agent](https://huggingface.co/spaces/MCP-1st-Birthday/Vehicle-Diagnostic-Assistant/tree/main/)
- [Gradio ODB-II Simulator MCP](https://huggingface.co/spaces/MCP-1st-Birthday/Vehicle-Diagnostic-Assistant/tree/main/MCP_servers/gradio-OBD2-simulator)