Skip to content

itsomg134/private-AI-assistant

Repository files navigation

🧠 Neuro AI Assist

Version Python License Platform

A real-time AI voice assistant built from scratch β€” backend to frontend β€” using Murf Falcon TTS and Docker

Features β€’ Installation β€’ Usage β€’ Demo β€’ Contributing

Untitled.video-11_22_2025.4_54.PM.mp4

πŸ“‹ Overview

Neuro AI Assist is a real-time AI voice agent that responds to voice commands through a browser interface. Built as part of the #MurfAIALAgentsChallenge, this project demonstrates full-stack voice AI development, from Dockerized backend to frontend integration.

This project aims to provide accessible AI voice technology, especially for rural users, enabling access to information and services in local languages.

Screenshot 2025-11-22 172521

✨ Features

πŸ”Š Core Capabilities

  • Real-time voice recognition and response
  • Natural-sounding text-to-speech using Murf Falcon
  • Full conversation simulation
  • Localhost browser interface at localhost:3000
  • Session recording for debugging and demos
Screenshot (123)

πŸ”§ Technical Features

  • Dockerized full-stack deployment
  • Frontend: React.js
  • Backend: FastAPI (or Node.js depending on setup)
  • Handles multiple setup errors gracefully
  • Lightweight and cross-platform compatible
Screenshot (126)

πŸš€ Installation

Prerequisites

  • Docker & Docker Compose
  • Node.js 18+ / Python 3.11+
  • Git

Steps

Screenshot (125)
# Clone repository
git clone https://github.com/itsomg134/neuro-ai-assist.git
cd neuro-ai-assist

# Build and run Docker containers
docker compose up --build

# Open in browser
http://localhost:3000

πŸ’» Usage

Day 1 Demo

  • Connected voice agent in browser
  • Tested simple conversation
  • Recorded initial session with TTS output
  • Overcame Docker and hardware setup challenges

Typical Interaction

User: Hello, Neuro AI Assist!
Agent: Hello! How can I help you today?
User: What's the weather in Mumbai?
Agent: Currently, it's 29Β°C with partly cloudy skies.

🎯 Purpose

This project is a personal mission: to build voice agents that can help people, especially in rural India, access information, services, and support in their own language.


πŸ“Ή Demo Video

https://drive.google.com/file/d/1Pr_5vPJ2ujUc96Uwd9JGI849EvYMT-Pw/view?usp=drive_link


πŸ—οΈ Technical Architecture

  • Frontend: React.js
  • Backend: FastAPI / Node.js
  • Dockerized for easy deployment
  • TTS powered by Murf Falcon

🀝 Contributing

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/YourFeature)
  3. Commit changes (git commit -m 'Add feature')
  4. Push to branch (git push origin feature/YourFeature)
  5. Open a Pull Request

πŸ“ License

MIT License β€” see the LICENSE file.


πŸ‘¨β€πŸ’» Author

Om Gedam

Made with ❀️ using Python, React, and Docker

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published