Update README and requirements

README.md

@@ -1,19 +1,61 @@
 ---
 title: Weather App
-emoji: 🚀
-colorFrom: red
-colorTo: red
+emoji: 🌤️
+colorFrom: blue
+colorTo: lightblue
 sdk: docker
 app_port: 8501
 tags:
 - streamlit
+- weather
 pinned: false
-short_description: Streamlit template space
+short_description: A weather app built with Streamlit
 ---
 
-# Welcome to Streamlit!
+# 🌤️ Weather Web App
 
-Edit `/src/streamlit_app.py` to customize this app to your heart's desire. :heart:
+A interactive web application built with Streamlit to get current weather information for any city.
 
-If you have any questions, checkout our [documentation](https://docs.streamlit.io) and [community
-forums](https://discuss.streamlit.io).
+## How It Works
+
+The app runs a server that users can interact with through their browser in a continuous loop:
+
+```mermaid
+sequenceDiagram
+    participant U as 👤 User
+    participant B as 🌐 Browser
+    participant S as 🚀 Server
+    participant W as 🌐 API
+
+    U->>B: Visits app URL
+    B->>S: Loads page
+    S->>B: Shows input form
+
+    loop 🔁 Each Search
+        U->>B: Enters city & clicks "Get Weather"
+        B->>S: Sends city name
+        S->>W: 🔍 Fetches weather
+        W->>S: Sends data
+        S->>B: Updates with weather info
+        B->>U: 📊 Displays results
+    end
+```
+
+## Run Locally
+
+1. Get an API key from [OpenWeatherMap](https://home.openweathermap.org/users/sign_up)
+2. Copy `.env.example` to `.env` and add your key
+3. Install deps: `pip install -r requirements.txt`
+4. Run: `streamlit run src/streamlit_app.py`
+
+## Deploy on Hugging Face
+
+1. Push code to a GitHub repo
+2. Create a new Streamlit Space on HF
+3. **Add your API key as a secret** in Space Settings:
+   - Name: `OPENWEATHER_API_KEY`
+   - Value: `your_actual_key_here`
+
+## License
+
+MIT License - feel free to use this project for learning and development!

requirements.txt

@@ -1,3 +1,3 @@
 requests==2.31.0
 python-dotenv==1.0.0
-streamlit
+streamlit==1.28.1