Content
# RideHermes
> AI-Driven Intelligent Ride Platform
[]()
[]()
[]()
[]()
## Introduction
RideHermes is an **AI-First** intelligent ride platform that supports voice calling, MCP protocol integration, and real-time location tracking.
### Core Features
- 🎤 **Voice AI Calling** — Simply say your destination to place an order
- 🔌 **MCP Server** — AI entities call via standard protocol
- 🗺️ **AMap** — Precise positioning, POI search, route planning
- 📍 **Real-time Tracking** — WebSocket real-time location push
- 📱 **Full-Stack Coverage** — Passenger, driver, and management backend
## Project Structure
```
ridehermes/
├── src/
│ ├── ride-hermes/ # Go backend service
│ ├── admin-web/ # React management backend
│ ├── passenger-app/ # Flutter passenger app
│ ├── driver-app/ # Flutter driver app
│ ├── ai-service/ # Python AI service
│ └── ride-hermes-mcp/ # MCP Server
├── docs/ # 📚 Project documentation
└── README.md # This file
```
## Quick Start
```bash
# 1. Start database
cd src && docker compose up -d mysql redis
# 2. Start backend
cd ride-hermes && go run ./cmd/server
# 3. Start management backend
cd admin-web && pnpm dev
```
## 📚 Documentation
**👉 [Full Documentation](./docs/README.md)**
| Document | Description |
|------|------|
| [Product Requirements](./docs/03-prd.md) | Feature list, user stories, roadmap |
| [Architecture Design](./docs/architecture/) | C4 model, technology selection |
| [API Documentation](./docs/api/overview.md) | RESTful API interface |
| [Design System](./docs/DESIGN.md) | Color, font, component specifications |
| [Deployment Guide](./docs/guides/deployment.md) | Production environment deployment |
| [Development Guide](./docs/guides/development.md) | Local development environment |
| [Operations Manual](./docs/RUNBOOK.md) | Monitoring, troubleshooting |
## MCP Server
Let AI entities help you call a ride:
```bash
npx ridehermes-mcp-server setup
```
## Tech Stack
| Module | Technology |
|------|------|
| Backend | Go + Gin + GORM |
| Database | MySQL 8.0 + Redis 7.2 |
| Management Backend | React 18 + Ant Design + TypeScript |
| Mobile | Flutter 3.24 + Riverpod |
| MCP | TypeScript + Node.js |
| Map | AMap |
## License
MIT
