Update README.md

README.md

@@ -8,5 +8,84 @@ sdk_version: 6.3.0
 app_file: app.py
 pinned: false
 ---
+---
+title: Smolagents
+emoji: 📚
+colorFrom: indigo
+colorTo: indigo
+sdk: gradio
+sdk_version: 6.3.0
+app_file: app.py
+pinned: false
+---
+# Alfred AI Assistant - smolagents Framework
+
+A multi-functional AI assistant built with the **smolagents framework** that can:
+- 🔍 Search the web for current information
+- ⏰ Tell time in any timezone
+- 🧮 Perform calculations and currency conversions
+- 🌤️ Check weather anywhere
+- 📏 Convert between units
+- 🤖 List Hugging Face models
+- 🎨 Generate images (optional)
+
+## 🚀 Features
+
+- **7+ Specialized Tools**: Each optimized for different tasks
+- **Real-time Data**: Web search, weather, currency rates
+- **Smart Tool Selection**: Agent automatically chooses the right tool
+- **User-friendly Interface**: Clean Gradio UI
+- **Educational**: Perfect for learning smolagents framework
+
+## 📋 Available Tools
+
+1. **web_search_tool** - Search DuckDuckGo for current information
+2. **get_current_time_in_timezone** - Time in any timezone
+3. **calculator_tool** - Math + currency conversion
+4. **huggingface_models_tool** - List popular HF models
+5. **weather_tool** - Current weather worldwide
+6. **unit_conversion_tool** - Convert units (length, weight, temp, etc.)
+7. **image_generation_tool** - Generate images from text
+
+## 🎯 Example Queries
+
+- "What are the latest AI news?"
+- "What time is it in Tokyo?"
+- "Calculate 15% of 250 + tax"
+- "Convert 100 USD to EUR"
+- "Weather in Paris"
+- "10 km to miles"
+- "List text-generation models on Hugging Face"
+
+## 🛠️ Technical Details
+
+- **Framework**: smolagents
+- **LLM**: Qwen/Qwen2.5-Coder-32B-Instruct (via Hugging Face)
+- **UI**: Gradio
+- **Deployment**: Hugging Face Spaces
+
+## 📁 Files
+
+- `app.py` - Main application with agent and tools
+- `prompts.yaml` - System prompts and configuration
+- `requirements.txt` - Python dependencies
+
+## 🚀 Deployment
+
+1. Create a new Space on Hugging Face
+2. Choose **Gradio** SDK
+3. Upload all files
+4. The Space will build automatically
+
+## 📚 Course Context
+
+This project is for **Unit 2: Frameworks for AI Agents** of the HuggingFace AI Agents Course, demonstrating the **smolagents framework**.
+
+## ⚠️ Limitations
 
+- Web search limited to 3 results (for speed)
+- Some APIs have rate limits
+- Image generation requires specific hardware
+- Model may be overloaded during peak times
+  
 Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference