Update README.md

README.md

@@ -1,16 +1,85 @@
 ---
-title: ReACT
-emoji: 💬
-colorFrom: yellow
+title: ReAct - Reasoning Modes Comparison
+emoji: 🧠
+colorFrom: blue
 colorTo: purple
 sdk: gradio
-sdk_version: 5.42.0
+sdk_version: 6.0.2
 app_file: app.py
 pinned: false
-hf_oauth: true
-hf_oauth_scopes:
-- inference-api
-license: apache-2.0
+license: mit
 ---
 
-An example chatbot using [Gradio](https://gradio.app), [`huggingface_hub`](https://huggingface.co/docs/huggingface_hub/v0.22.2/en/index), and the [Hugging Face Inference API](https://huggingface.co/docs/api-inference/index).
+# 🧠 LLM Reasoning Modes Comparison
+
+This Space demonstrates and compares three different reasoning paradigms for Large Language Models using **openai/gpt-oss-20b**:
+
+## 🎯 Reasoning Modes
+
+### 1. **Think-Only** (Chain-of-Thought)
+- Uses internal reasoning and knowledge only
+- Shows step-by-step thought process
+- No external tool access
+- Best for: Problems solvable with general knowledge
+
+### 2. **Act-Only** (Tool Use)
+- Uses external tools to gather information
+- Shows actions and observations only
+- Minimal explicit reasoning
+- Best for: Fact-checking and real-time data retrieval
+
+### 3. **ReAct** (Reasoning + Acting)
+- Interleaves Thought → Action → Observation
+- Combines reasoning with tool use
+- Most comprehensive approach
+- Best for: Complex problems requiring both reasoning and external data
+
+## 🛠️ Available Tools
+
+The agent has access to these real external tools:
+
+- **🔍 DuckDuckGo Search**: Web search for current information
+- **📚 Wikipedia Search**: Detailed encyclopedic knowledge
+- **🌤️ Weather API**: Real-time weather data for any location
+- **🧮 Calculator**: Safe mathematical expression evaluation
+- **🐍 Python REPL**: Execute Python code for data processing
+
+## 🚀 How to Use
+
+1. Enter your question in the text box
+2. Select a reasoning mode (or "All" to compare)
+3. Click "Run" to see the agent work in real-time
+4. Watch as thoughts, actions, and observations unfold
+
+## 📝 Example Questions
+
+- "What is the capital of France and what's the current weather there?"
+- "Who wrote 'To Kill a Mockingbird' and when was it published?"
+- "Calculate the compound interest on $1000 at 5% annual rate for 3 years"
+- "What is the population of Tokyo and how does it compare to New York City?"
+
+## 🔧 Setup
+
+To run this Space, you need to set your Hugging Face token:
+
+1. Go to Space Settings → Repository Secrets
+2. Add a secret named `HF_TOKEN` with your Hugging Face API token
+3. The Space will automatically use this token to access the model
+
+## 📚 Technical Details
+
+- **Model**: openai/gpt-oss-20b (via Hugging Face Inference API)
+- **Framework**: Gradio for the UI
+- **Agent Format**: Inspired by smolagents/ReAct paradigm
+- **Streaming**: Real-time display of intermediate steps
+
+## 🎓 Learn More
+
+This implementation demonstrates the ReAct (Reason + Act) paradigm described in:
+- Yao et al. (2022) "ReAct: Synergizing Reasoning and Acting in Language Models"
+
+The three modes show how different combinations of reasoning and tool use affect problem-solving capabilities.
+
+## 📄 License
+
+MIT License - feel free to use and modify!