AI-powered emergency crisis navigator that reasons over photos/videos to provide immediate, actionable intervention plans.
Navigator AI bridges the critical gap between an emergency event and professional response. By leveraging Gemini 3 Pro, it analyzes visual scenes in seconds to detect hazards, classify urgency, and generate tactical step-by-step checklists.
- 📸 Multimodal Analysis: Upload images or take photos directly. The system identifies objects, hazards, and environmental context.
- 📝 Tactical Intervention Plans: Converts chaotic situations into clear, prioritized checklists with estimated times for every step.
- 🧠 Reasoning Trace: A "Chain of Thought" UI that explains why the AI recommended specific actions, building user trust.
- 🗣️ Live Voice Mode: Real-time, low-latency voice conversation using
gemini-2.5-flash-native-audiofor hands-free assistance. - 🚨 Urgency Classification: Automatic detection of Critical, Medium, or Low urgency states with appropriate UI alerts (visual/haptic/audio).
- 💾 Offline-First: Saves incident history locally and caches the active plan for reliable access in spotty network conditions.
- Node.js 18+
- A Google AI Studio API Key with access to
gemini-3-pro-previewandgemini-2.5-flash-native-audio-preview-09-2025.
-
Clone the repository
git clone https://github.com/your-org/navigator-ai.git cd navigator-ai -
Install dependencies
npm install
-
Configure API Key Set your API key in your environment variables.
export API_KEY="your_google_ai_studio_key"
Note: In a local development environment using Vite/Webpack, you might need to use a
.envfile. Ensureprocess.env.API_KEYis accessible. -
Run the development server
npm start # or npm run dev -
Open the app Navigate to
http://localhost:3000(or the port shown in your terminal).
Detailed documentation regarding the project roadmap, architecture, and AI implementation can be found in the docs/ folder:
- MVP Roadmap & Idea Inbox: Current status and future features.
- Architecture Decisions: Tech stack, state management, and offline strategies.
- Prompt Engineering: How we structure prompts, enforce JSON schemas, and use reasoning traces.
- Frontend: React 19, TypeScript, Tailwind CSS
- Icons: Lucide React
- AI SDK:
@google/genai(Unified SDK) - Models:
- Analysis:
gemini-3-pro-preview - Live Voice:
gemini-2.5-flash-native-audio-preview-09-2025
- Analysis:
Navigator AI is a guidance support tool. It is not a replacement for professional emergency services (911/999/112). In life-threatening situations, always contact local authorities immediately.
MIT License. See LICENSE for details.