🤖 HAMMAD BHAI – Beginner-Friendly Multilingual AI Agent 🌐

Welcome to HAMMAD BHAI, a simple yet powerful multilingual AI chatbot built using Gemini 2.0 Flash and Chainlit.
Created with ❤️ by MUHAMMAD HAMMAD ZUBAIR, this chatbot is your digital best friend — talk to him in any language, and he replies with emotions and respect 😄🌍

🧠 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 language detection)
✨ Gemini 2.0 Flash powered AI (Fast, latest model by Google)
✨ Emotional & Respectful Replies with full Emoji support 🥰
✨ Beginner-Friendly AI Agent – For learning and fun
✨ Built with Python + Chainlit + Google AI
✨ Fully Open Source – Use, Learn, Modify
✨ Perfect for students, learners, and educators 🎓👨‍🏫

📂 Project Structure

📂 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/Simple_AI_Agent.git && cd Simple_AI_Agent && pip install -r requirements.txt && chainlit run main.py

2) 🪄 Simple One-Line Setup via NPX

npx simple-agent-hammad@latest

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

1. 🔐 Clone the Repository

git clone https://github.com/MUHAMMAD-HAMMAD-ZUBAIR/Simple_AI_Agent.git
cd Simple_AI_Agent

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

After that, it will launch in your browser — and your AI buddy HAMMAD BHAI 🤖 will be ready to chat.

🌎 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. Feel free to use, remix, or extend it however you like. 🚀

🪖 Special Message

If you found this chatbot helpful, don’t forget to ⭐ star the repo and share it. Let’s make AI more human, respectful, and fun! 🤖❤️

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