How bunsdev/perplexica-search-engine-ai works
Vane is a privacy-focused AI answering engine: users configure models and search preferences, ask questions, and receive streamed answers with cited sources, suggestions, and contextual widgets. Chat requests load configured models and hand research to a search agent; search mode also has a separate API agent. The graph preserves documented discovery, media search, uploads, history, and provider configuration. Some subsystem paths and links are based on the README or SOURCE INDEX rather than inspected implementations; dashed links mark unverified integration.
Main entry points: route.ts Chat endpoint · index.ts Search agent · manager.ts Upload processing · registry.ts Model registry
Components 26
User experience
- Chat interface
src/components/ChatWindow.tsx - Chat state
src/lib/hooks/useChat.tsx - Discover and library
src/app/discover/page.tsx - Settings and setup
src/components/Settings/SettingsField.tsx
Application API
- Chat endpoint
src/app/api/chat/route.ts - Search endpoint
src/app/api/search/route.ts - Feature endpoints
src/app/api/discover/route.ts - Upload endpoint
src/app/api/uploads/route.ts
Search and enrichment
- Search agent
src/lib/agents/search/index.ts - API search agent
src/lib/agents/search/api.ts - Research actions
src/lib/agents/search/researcher - Context widgets
src/lib/agents/search/widgets - Image and video search
src/lib/agents/media/image.ts - Answer suggestions
src/lib/agents/suggestions/index.ts - SearxNG search
src/lib/searxng.ts
Models and configuration
- Model registry
src/lib/models/registry.ts - Provider adapters
src/lib/models/providers/index.ts - LLM interface
src/lib/models/base/llm.ts - Provider configuration
src/lib/config/index.ts - Embedding interface
src/lib/models/base/embedding.ts
Persistence and files
- Chat database
src/lib/db/schema.ts - Live sessions
src/lib/session.ts - Upload processing
src/lib/uploads/manager.ts - Text chunking
src/lib/utils/splitText.ts - Upload files
src/lib/uploads/store.ts
Other components
- User
Connections 27
- User → Chat interface: asks questions
README.md - User → Settings and setup: configures models
README.md - User → Discover and library: browses content
README.md - Chat interface → Chat state: uses state
src/components/ChatWindow.tsx - Chat endpoint → Model registry: loads models
src/app/api/chat/route.ts - Chat endpoint → Search agent: starts research
src/app/api/chat/route.ts - Chat endpoint → Live sessions: creates session
src/app/api/chat/route.ts - Chat endpoint → Chat database: checks chat
src/app/api/chat/route.ts - Search endpoint → Model registry: loads models
src/app/api/search/route.ts - Search endpoint → API search agent: starts search
src/app/api/search/route.ts - Search agent → Research actions: runs research
src/lib/agents/search/index.ts - Search agent → Context widgets: uses widgets
src/lib/agents/search/index.ts - Search agent → Chat database: uses chat data
src/lib/agents/search/index.ts - API search agent → Research actions: runs research
src/lib/agents/search/api.ts - Model registry → Provider adapters: selects adapters
src/lib/models/registry.ts - Model registry → Provider configuration: reads configuration
src/lib/models/registry.ts - Provider adapters → LLM interface: implements interface
- Feature endpoints → SearxNG search: fetches discovery
src/app/api/discover/route.ts - Image and video search → SearxNG search: searches media
src/lib/agents/media/image.ts - Feature endpoints → Image and video search: dispatches media search
- Chat state → Answer suggestions: requests suggestions
- Upload endpoint → Upload processing: processes uploads
src/app/api/uploads/route.ts - Upload processing → Text chunking: chunks text
src/lib/uploads/manager.ts - Upload processing → Embedding interface: embeds chunks
src/lib/uploads/manager.ts - Upload processing → Upload files: stores files
- Research actions → SearxNG search: searches web
- Settings and setup → Provider configuration: updates settings