Skip to content

ShivaKumarS-code/helpnow-ai

Repository files navigation

❤️ HelpNow AI: Real-Time Emergency Guidance

Next.js TypeScript React Tailwind CSS AI Powered

HelpNow AI is a life-saving web application that provides instant, step-by-step guidance for medical emergencies. Using advanced speech recognition and AI-powered responses, it delivers clear instructions with visual aids to help users and also handle critical situations when every second counts.


🚀 Live Demo

🌐 Experience HelpNow AI in action: Live Demo

Try the emergency guidance system with voice recognition and real-time AI responses!


🛠️ Tech Stack

🎨 Frontend Next.js, React, TypeScript, Tailwind CSS
⚡ Backend Next.js API Routes
🤖 AI Services Cerebras API, Pollinations.ai
🎤 Speech Recognition @picovoice/picovoice-react
🔊 Text-to-Speech Web Speech API

✨ Features

  • 🎤 Voice Recognition - Describe emergencies using natural speech
  • 🚨 Real-Time Guidance - Instant step-by-step emergency instructions
  • 🔊 Audio Instructions - Hands-free guidance with text-to-speech
  • 🖼️ Visual Aids - AI-generated images for each instruction step
  • 📱 Mobile Optimized - Works seamlessly on all devices
  • Lightning Fast - Optimized for emergency response time
  • 🛡️ Safety First - Built-in disclaimers and safety warnings
  • 🎯 Step Navigation - Easy navigation through emergency procedures

🏗️ Architecture

Core Framework

<frontend-stack>
  <framework>Next.js</framework>
  <language>TypeScript</language>
  <ui-library>React</ui-library>
  <styling>Tailwind CSS</styling>
  <speech>@picovoice/picovoice-react</speech>
  <tts>Web Speech API</tts>
</frontend-stack>

AI Pipeline

<ai-pipeline>
  <llm>
    <service>Cerebras API</service>
    <purpose>Emergency guidance generation</purpose>
  </llm>
  <image-generation>
    <service>Pollinations.ai API</service>
    <purpose>Visual instruction aids</purpose>
  </image-generation>
  <speech-processing>
    <input>Voice commands & descriptions</input>
    <output>Structured emergency responses</output>
  </speech-processing>
</ai-pipeline>

🚨 How It Works

  1. 🗣️ Voice Input - User clicks "Emergency" and describes the situation
  2. 🔄 Processing - Speech is converted to text and sent to backend API
  3. 🤖 AI Analysis - Cerebras API generates step-by-step emergency guidance
  4. 🖼️ Visual Generation - Pollinations.ai creates instructional images for each step
  5. 📱 Response Delivery - Frontend displays guidance with audio and visual aids
  6. 🎯 Step Navigation - Users navigate through instructions at their own pace
  7. 🔊 Audio Support - Instructions are read aloud for hands-free operation

📁 Project Structure

📦 helpnow-ai
├── 📂 src/
│   ├── 📂 app/                 # Next.js app router pages
│   ├── 📂 components/          # Reusable UI components
│   ├── 📂 contexts/            # React context providers
│   ├── 📂 hooks/               # Custom React hooks
│   └── 📂 utils/               # Utility functions & helpers
├── 📂 public/                  # Static assets & icons
├── 📄 .gitignore               # Git ignore patterns
├── 📄 README.md                # Project documentation
├── 📄 eslint.config.mjs        # ESLint configuration
├── 📄 next.config.ts           # Next.js configuration
├── 📄 package.json             # Dependencies & scripts
├── 📄 package-lock.json        # Dependency lock file
├── 📄 postcss.config.mjs       # PostCSS configuration
└── 📄 tsconfig.json            # TypeScript configuration

🔧 Key Technologies

🚨 Emergency Response

  • Cerebras API - High-performance AI for emergency guidance
  • Real-time Processing - Instant response for critical situations
  • Step-by-step Instructions - Clear, actionable emergency procedures

🎤 Voice & Audio

  • @picovoice/picovoice-react - Advanced speech recognition
  • Web Speech API - Natural text-to-speech output
  • Hands-free Operation - Critical for emergency situations

🖼️ Visual Intelligence

  • Pollinations.ai - AI-generated instructional images
  • Dynamic Visuals - Custom images for each emergency step
  • Visual Learning - Enhanced understanding through imagery

🎨 Modern Web Stack

  • Next.js 14 - Full-stack React framework
  • TypeScript - Type-safe development
  • Tailwind CSS - Responsive, mobile-first design

🌟 What Makes HelpNow AI Special

⚡ Emergency Speed Optimized for life-critical response times
🎤 Voice-First Design Hands-free operation when it matters most
🖼️ Visual Learning AI-generated images enhance instruction clarity
📱 Universal Access Works on any device, anywhere, anytime

🚨 Important Disclaimer

⚠️ Medical Emergency Disclaimer
HelpNow AI provides general guidance and should not replace professional medical care. In life-threatening emergencies, always call your local emergency services (911, 112, etc.) immediately. This application is designed to provide supplementary guidance while waiting for professional help.

🚀 Getting Started

Ready to build life-saving technology? Here's how:

  1. 📥 Clone the repository to your local machine
  2. 📦 Install dependencies with npm install
  3. 🔧 Configure your API keys for Cerebras ai
  4. 🚀 Run the development server with npm run dev
  5. 🌐 Access the application at http://localhost:3000

🤝 Contributing

Help us save lives through technology:

  • 🐛 Report Issues - Found a bug? Every fix could save a life
  • 💡 Feature Requests - Ideas for better emergency response?
  • 🔧 Code Contributions - Submit PRs to improve the platform
  • Star the Repo - Help others discover this life-saving tool

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.


Built with ❤️ for Emergency Response
Every second counts. Every life matters.

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •