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
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.
- 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
- 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
- Docker & Docker Compose
- Node.js 18+ / Python 3.11+
- Git
# 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- Connected voice agent in browser
- Tested simple conversation
- Recorded initial session with TTS output
- Overcame Docker and hardware setup challenges
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.
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.
https://drive.google.com/file/d/1Pr_5vPJ2ujUc96Uwd9JGI849EvYMT-Pw/view?usp=drive_link
- Frontend: React.js
- Backend: FastAPI / Node.js
- Dockerized for easy deployment
- TTS powered by Murf Falcon
- Fork the repository
- Create a feature branch (
git checkout -b feature/YourFeature) - Commit changes (
git commit -m 'Add feature') - Push to branch (
git push origin feature/YourFeature) - Open a Pull Request
MIT License β see the LICENSE file.
Om Gedam
- GitHub: @itsomg134
- Email: omgedam123098@gmail.com
- Twitter: @omgedam
- LinkedIn: Om Gedam
- Portfolio: ogworks.lovable.app
Made with β€οΈ using Python, React, and Docker