How seyric/vigilens works
Vigilens is a desktop investigation and crime-intelligence platform. An operator enters through the routed React workspace; the Electron shell can start the local FastAPI service. Backend routes expose investigation, analytics, AI, crime-pattern, and OSINT capabilities. One evidenced case-analysis path accepts an uploaded report, extracts and parses it, optionally enriches it with Gemini, then searches for matching records. The README documents broader graph, GIS, threat-intelligence, and forensic capabilities; their detailed wiring is not established by the sampled source.
Main entry points: main.py FastAPI gateway · AppRoutes.tsx Workspace routes · upload_controller.py Upload controller · router.py OSINT API
Components 24
Desktop workspace
- Electron shell
electron/main.cjs - Workspace routes
src/routes/AppRoutes.tsx - Investigation workspace
src/pages/Investigation/InvestigationPage.tsx - Pattern analysis UI
src/pages/CrimePatternSimilarity/AICrimePatternSimilarityPageFull.tsx - GIS workspace
src/pages/GIS/GISPage.tsx - OSINT workspace
src/pages/OSINT/OSINTTacticalMapPage.tsx
API and access
- FastAPI gateway
backend/main.py - Authentication
backend/auth/router.py - Core investigation API
backend/core/router.py
Case intelligence
- Crime-pattern API
backend/crime_pattern/routes/router.py - Upload controller
backend/crime_pattern/controllers/upload_controller.py - Document extraction
backend/crime_pattern/ocr/extractor.py - Entity parsing
backend/crime_pattern/parsers/entity_parser.py - AI enrichment
backend/crime_pattern/services/enrichment.py - Record matching
backend/crime_pattern/services/search.py
Threat intelligence
- OSINT API
backend/osint/router.py - Multi-INT collectors
backend/osint/collectors - Live feed store
backend/osint/services/live_store.py
Analytics and storage
- Analytics API
backend/analytics/router.py - Crime analytics
analytics - Geospatial analysis
gis - Criminal graph
neo4j - Relational database
database
Other components
- Investigator
Connections 22
- Investigator → Workspace routes: uses
- Workspace routes → Investigation workspace: routes to
- Workspace routes → Pattern analysis UI: routes to
- Workspace routes → GIS workspace: routes to
- Workspace routes → OSINT workspace: routes to
- Electron shell → FastAPI gateway: starts service
- FastAPI gateway → Authentication: mounts
- FastAPI gateway → Core investigation API: mounts
- FastAPI gateway → Crime-pattern API: mounts
- FastAPI gateway → Analytics API: mounts
- FastAPI gateway → OSINT API: mounts
- Crime-pattern API → Upload controller: dispatches
- Upload controller → Document extraction: extracts text
- Upload controller → Entity parsing: parses text
- Upload controller → AI enrichment: enriches data
- Upload controller → Record matching: searches matches
- Analytics API → Crime analytics: serves analytics
- GIS workspace → Geospatial analysis: geospatial capability
- OSINT API → Multi-INT collectors: collects feeds
- OSINT API → Live feed store: uses feed store
- Record matching → Relational database: queries records
- Core investigation API → Criminal graph: network analysis