---
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