VANESSA Documentation

VANESSA (Versatile AI Navigator for Enhanced Semantic Search & Automation) is a modular, local-first AI assistant stack.

Quickstart

1. Clone the repository.
2. Start local staging from the project root:

./ops/local-staging/start.sh
./ops/local-staging/health.sh

1. Open the frontend at http://localhost:3000.

What You Get

• Responsive web frontend
• Flask backend API
• Agent orchestration service
• Sandbox for controlled code execution
• MCP gateway for remote/general-purpose tool execution, including SearXNG-backed web search
• LLM gateway and split local runtimes
• Wake-word service
• Weaviate vector store
• PostgreSQL database

Next Pages

• Architecture
• Setup
• Local Staging
• Services
• Retrieval Contract
• ModelOps
• Testing
• Security/Secrets
• Contributing

Owner: Core platform maintainers. Update cadence: with every service or runtime behavior change.