diff --git a/README.md b/README.md
index df22c69f..ee3b0592 100644
--- a/README.md
+++ b/README.md
@@ -19,7 +19,16 @@
 
 ## ✨ Overview
 
-**KrishiMitra 2.0** is an open-source, AI-powered digital assistant tailored for Indian farmers. With a mission to bridge the tech gap in agriculture, it provides real-time solutions for **crop disease detection**, **multilingual remedies**, **mandi prices**, **weather updates**, and more — all through an intuitive interface.
+**KrishiMitra 2.0** is an open-source, AI-powered digital assistant tailored for Indian farmers. With a mission to bridge the tech gap in agriculture, it provides real-time solutions for:
+
+- 🌾 Crop disease detection  
+- 💬 Multilingual remedies (via TTS)  
+- 📊 Mandi price tracking  
+- ☁️ Weather updates  
+- 🌱 Crop recommendations  
+- 🧾 Government scheme info
+
+All through a **simple, easy-to-use Streamlit interface**.
 
 ---
 
@@ -41,9 +50,15 @@
 
 - **Frontend**: [Streamlit](https://streamlit.io/)
 - **Backend**: Python
-- **ML Libraries**: OpenCV, scikit-learn (upcoming)
-- **APIs**: OpenWeatherMap, Agmarknet
-- **Tools**: `gTTS`, `Pillow`, `Geopy`, `Requests`
+- **ML Libraries**: OpenCV, scikit-learn *(upcoming)*
+- **APIs**:
+  - [OpenWeatherMap](https://openweathermap.org/)
+  - [Agmarknet (Mandi Prices)](https://agmarknet.gov.in/)
+- **Tools**:
+  - `gTTS` (Google Text-to-Speech)
+  - `Pillow` (Image processing)
+  - `Geopy` (Geolocation)
+  - `Requests` (API calls)
 
 ---
 
@@ -58,8 +73,67 @@ KrishiMitra/
 │   └── crop_recommender.py
 ├── data/               # JSON / CSV files
 ├── assets/             # Images / audio
-├── krishimitra_app.py  # Main app
-├── requirements.txt
+├── krishimitra_app.py  # Main Streamlit app
+├── requirements.txt    # All dependencies
 └── README.md
 
+🚀 Getting Started
+✅ Prerequisites
+Python 3.8+
+Streamlit (pip install streamlit)
+Other libraries: gTTS, Pillow, requests, geopy, opencv-python
+
+Install :
+
+bash command
+
+pip install -r requirements.txt
+▶️ Run the App
+
+bash command
+
+streamlit run krishimitra_app.py
+
+
+🤝 Contributing
+We welcome contributions from developers, researchers, and agri-enthusiasts!
+To contribute:
+
+Fork the repo
+
+Create a new branch
+
+Make your changes
+
+Open a Pull Request
+
+📌 Future Roadmap
+ AI-powered ChatBot assistant
+
+ Voice Command Interface in regional languages
+
+ Farmer crop diary & reminders
+
+ Disease prediction via time-series ML models
+
+ Full mobile app version
+
+🧑‍🌾 Made For
+This project is proudly made for Girlscript Summer of Code 2025 (GSSoC) and aims to uplift the farming ecosystem in India through accessible AI tools.
+
+📜 License
+This project is licensed under the MIT License.
+
+🌟 Star this repo to support the cause of smart agriculture in India!
+yaml
+Copy
+Edit
+
+---
+
+Let me know if you want:
+- Translated content in Hindi/Tamil/etc.
+- Custom logo/banner
+- GitHub-friendly `.md` formatting with emojis/icons optimized for dark/light themes
+- Contribution guidelines