File size: 2,324 Bytes
bca58e3
 
 
 
 
 
 
 
 
 
7c6d9b1
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
bddf94a
7c6d9b1
 
 
 
 
 
 
 
 
 
 
 
 
 
bddf94a
 
7c6d9b1
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
bddf94a
7c6d9b1
 
bca58e3
7c6d9b1
 
 
 
 
bca58e3
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
---
title: Smolagents2
emoji: 
colorFrom: yellow
colorTo: green
sdk: gradio
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
- Translator

## 🚀 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. **weather_tool** - Current weather worldwide
5. **unit_conversion_tool** - Convert units (length, weight, temp, etc.)

## 🎯 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"

## 🛠️ 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 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