chat-with-hammad/README.md

CLI to launch HAMMAD BHAI AI chatbot instantly

# 🤖 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)

```bash
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 app/main.py
```

### 2) 🪄 Simple One-Line Setup via NPX

```bash
npx chat-with-hammad@latest
```

---


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

### 1. 🔐 Clone the Repository

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

### 2. 📦 Install Requirements

```bash
pip install -r requirements.txt
```

### 3. 🧶 Create `.env` File

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

```env
GOOGLE_API_KEY=your_real_google_api_key_here
```

### 4. ▶️ Run the Chatbot

```bash
chainlit run app/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](https://github.com/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
```