Skip to content

shubham36-it/Virtual-Assistant

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 

Repository files navigation

🤖 Virtual Assistant (JARVIS-Style)

In this mind-blowing full-stack project, I’ve built a JARVIS-style AI Virtual Assistant using the MERN Stack (MongoDB, Express, React, Node.js) and deployed it for FREE on Render 🚀.

This assistant can talk, think, remember, and look the way you want – just like your own personalized AI companion!

🌐 Live Demo: Virtual Assistant


✨ Features

  • 🎙 Voice Input + Output – Talks naturally using Web Speech API
  • 🧠 Smart AI Brain – Powered by Gemini AI for intelligent replies
  • 🔐 Authentication System – Secure JWT + bcryptjs login/signup
  • 🖼 Custom Assistant Image – Upload your own avatar with Cloudinary + Multer
  • 🏷 Personalized Branding – Customize your assistant’s name & voice
  • 📱 Fully Responsive – Works across devices
  • ☁️ Free Deployment – Hosted on Render

🛠 Tech Stack

Frontend: React, Tailwind CSS, Web Speech API
Backend: Node.js, Express.js
Database: MongoDB (Atlas)
AI Integration: Gemini AI
Auth & Security: JWT, bcryptjs
File Uploads: Multer, Cloudinary
Deployment: Render


🚀 Getting Started

1. Clone the Repo

git clone https://github.com/shubham36-it/Virtual-Assistant.git
cd Virtual-Assistant
2. Install Dependencies
For server:

bash
Copy code
cd server
npm install
For client:

bash
Copy code
cd client
npm install
3. Setup Environment Variables
Create a .env file in the server folder with:

ini
Copy code
MONGO_URI=your_mongodb_connection
JWT_SECRET=your_secret_key
CLOUDINARY_NAME=your_cloudinary_name
CLOUDINARY_API_KEY=your_cloudinary_api_key
CLOUDINARY_API_SECRET=your_cloudinary_secret
4. Run the App
Start backend:

bash
Copy code
cd server
npm start
Start frontend:

bash
Copy code
cd client
npm run dev
📸 Screenshots
(Add screenshots/gifs here of signup, assistant talking, etc.)

🧑‍💻 Author
Shubham – GitHub

⭐ Contribute
Pull requests are welcome! For major changes, please open an issue first to discuss what you’d like to change.

If you like this project, don’t forget to star ⭐ the repo!

vbnet
Copy code

Do you want me to also add a **step-by-step usage guide** (like how to sign up, upload an image, and talk to the assistant), or keep it professional and short?
















markdown
Copy code
# 🤖 Virtual Assistant (JARVIS-Style)

In this mind-blowing **full-stack project**, I’ve built a **JARVIS-style AI Virtual Assistant** using the **MERN Stack (MongoDB, Express, React, Node.js)** and deployed it for **FREE on Render** 🚀.  

This assistant can **talk, think, remember, and look the way you want** – just like your own personalized AI companion!  

🌐 **Live Demo:** [Virtual Assistant](https://virtual-assistant-eud4.onrender.com/signup)

---

## ✨ Features

- 🎙 **Voice Input + Output** – Talks naturally using **Web Speech API**  
- 🧠 **Smart AI Brain** – Powered by **Gemini AI** for intelligent replies  
- 🔐 **Authentication System** – Secure **JWT + bcryptjs** login/signup  
- 🖼 **Custom Assistant Image** – Upload your own avatar with **Cloudinary + Multer**  
- 🏷 **Personalized Branding** – Customize your assistant’s **name & voice**  
- 📱 **Fully Responsive** – Works across devices  
- ☁️ **Free Deployment** – Hosted on **Render**

---

## 🛠 Tech Stack

- **Frontend:** React, Tailwind CSS, Web Speech API  
- **Backend:** Node.js, Express.js  
- **Database:** MongoDB (Atlas)  
- **AI Integration:** Gemini AI  
- **Authentication & Security:** JWT, bcryptjs  
- **File Uploads:** Multer, Cloudinary  
- **Deployment:** Render  

---

## 🚀 Getting Started

Follow these steps to run the project locally:

### 1. Clone the Repository
```bash
git clone https://github.com/shubham36-it/Virtual-Assistant.git
cd Virtual-Assistant
2. Install Dependencies
For the server:

bash
Copy code
cd server
npm install
For the client:

bash
Copy code
cd client
npm install
3. Setup Environment Variables
Create a .env file inside the server folder and add:

ini
Copy code
MONGO_URI=your_mongodb_connection_string
JWT_SECRET=your_secret_key
CLOUDINARY_NAME=your_cloudinary_name
CLOUDINARY_API_KEY=your_cloudinary_api_key
CLOUDINARY_API_SECRET=your_cloudinary_api_secret
4. Run the App
Start the backend server:

bash
Copy code
cd server
npm start
Start the frontend:

bash
Copy code
cd client
npm run dev
Now open http://localhost:5173 in your browser 🎉

📸 Screenshots
Add your screenshots here for better presentation. Example sections:

🔑 Signup / Login Page

🤖 Assistant Talking with AI Responses

🖼 Upload Custom Avatar

📱 Mobile Responsive UI

📂 Project Structure
pgsql
Copy code
Virtual-Assistant/

├── client/              # React frontend
│   ├── src/
│   └── package.json

├── server/              # Node.js + Express backend
│   ├── models/
│   ├── routes/
│   ├── controllers/
│   └── package.json

└── README.md
🧑‍💻 Author
👤 Shubham

GitHub: @shubham36-it

⭐ Contributing
Contributions are welcome!

Fork the repo

Create a new branch (feature-branch)

Commit your changes

Push to the branch and open a PR

If you like this project, don’t forget to star ⭐ the repo!

📜 License
This project is licensed under the MIT License – feel free to use and modify it.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages