README.md

metadata

title: ReAct - Reasoning Modes Comparison
emoji: 🧠
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 4.44.0
app_file: app.py
pinned: false
license: mit

🧠 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!