File size: 1,105 Bytes
ca7a2c2 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 |
---
title: LocalMate API
emoji: 🌴
colorFrom: indigo
colorTo: purple
sdk: docker
app_port: 7860
pinned: false
---
# LocalMate Da Nang V2
Multi-Modal Contextual Agent (MMCA) API for Da Nang Tourism.
## Architecture
Based on **Model Context Protocol (MCP)** with 3 tools:
- **retrieve_context_text** - RAG Text search (pgvector)
- **retrieve_similar_visuals** - RAG Image search (CLIP)
- **find_nearby_places** - Graph Spatial (Neo4j)
## Quick Start
```bash
# Install dependencies
pip install -e ".[dev]"
# Copy env file
cp .env.example .env
# Edit .env with your credentials
# Run dev server
pkill -f "uvicorn app.main:app"
uvicorn app.main:app --reload --port 8000
# Open Swagger UI
open http://localhost:8000/docs
```
## Testing
Use the `/api/v1/chat` endpoint in Swagger to test:
```json
{
"message": "Tìm quán cafe gần bãi biển Mỹ Khê"
}
```
## Tech Stack
- **Framework**: FastAPI
- **Database**: Supabase (PostgreSQL + pgvector)
- **Graph DB**: Neo4j Aura
- **LLM**: Google Gemini 2.5 Flash or deepseek-ai/deepseek-v3.1-terminus
- **Embeddings**: text-embedding-004 + CLIP
|