metadata
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
# 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:
{
"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