🤖 HAMMAD BHAI – Your Friendly AI Chatbot 🌍

Welcome to HAMMAD BHAI, an open-source multilingual AI chatbot built using Gemini 2.0 Flash and Chainlit.
Created with ❤️ by MUHAMMAD HAMMAD ZUBAIR, this chatbot is designed to talk like your best friend — in any language, with full emoji support 😄🌐

🧠 What's Special?

"Main HAMMAD BHAI hoon 🤖, mujhe MUHAMMAD HAMMAD ZUBAIR ne banaya hai 💡. Main unki ek creative creation hoon – yahan hoon sirf tumhari madad ke liye! 🪖"

✨ Multilingual Responses (Auto detects language)
✨ Gemini 2.0 Flash powered AI (Fast, smart, latest model)
✨ Emotional Replies with Emojis 🥰
✨ Fully Open Source – Use, Learn, Modify
✨ Built with Python + Chainlit + Google AI
✨ Designed for students, educators, and developers 🎓👨‍💻

📂 Project Structure

project/
├── app/
│   └── main.py              # Main Chatbot App
├── .env                     # API key goes here
├── chainlit.md              # Welcome message for chatbot
├── pyproject.toml           # Python project dependencies
├── requirements.txt         # Install from here
├── uv.lock                  # Lock file
└── .chainlit/
    └── config.toml          # Chainlit settings

⚡ Quick One-Line Setup (2 OPTIONS)

1) 🧪 Manual Setup Command (for devs)

git clone https://github.com/MUHAMMAD-HAMMAD-ZUBAIR/CHAT-BOT-2.0.git && cd CHAT-BOT-2.0 && pip install -r requirements.txt && chainlit run main.py

2) 🪄 Simple One-Line Setup via NPX

npx chat-with-hammad@latest

✅ How to Run Manually (Step-by-step)

1. 🔐 Clone the Repository

git clone https://github.com/MUHAMMAD-HAMMAD-ZUBAIR/CHAT-BOT-2.0.git
cd CHAT-BOT-2.0

2. 📦 Install Requirements

pip install -r requirements.txt

3. 🧶 Create .env File

Create a .env file in the root directory and add your API Key:

GOOGLE_API_KEY=your_real_google_api_key_here

4. ▶️ Run the Chatbot

chainlit run main.py -w

Open the localhost link to chat with HAMMAD BHAI 🤖.

🌎 Language Support

This AI bot can auto-detect and reply in multiple languages including:
Urdu, Hindi, English, Pashto, Spanish, Arabic, and more... — with full emoji support 🎉💬

🧑‍💻 Developer Info

| Name | Role | GitHub Link | | -------------------------- | --------------- | ------------------------------------------------ | | MUHAMMAD HAMMAD ZUBAIR | Developer 👨‍💻 | @MUHAMMAD-HAMMAD-ZUBAIR |

📜 License

This project is licensed under the MIT License.
Use it freely, remix it, and build something awesome 🚀

🪖 Special Message

If you found this helpful, please consider giving a 🌟 on GitHub and spreading the word about HAMMAD BHAI.
Let’s build respectful AI that connects hearts through emotion and code ❤️

💡 DEVELOPED WITH ❤️ BY MUHAMMAD HAMMAD ZUBAIR  
🤖 POWERED BY GEMINI AI + CHAINLIT  
🌍 DESIGNED TO CONNECT HEARTS THROUGH CODE