Deploy ArkAssistant smolagent (Hugging Face Agents Course Unit 1)

README.md

@@ -1,6 +1,6 @@
 ---
-title: ArkAssistant Smolagent
-emoji: 🤖
+title: ArkAssistant Multi-Agent System
+emoji: 🧠
 colorFrom: indigo
 colorTo: purple
 sdk: gradio
@@ -10,23 +10,38 @@ pinned: false
 tags:
 - smolagents
 - agent
-- smolagent
+- multi-agent
+- hierarchical-agents
 - tool
 - agent-course
 ---
 
-# 🤖 ArkAssistant - Hugging Face Agents Course (Unit 1)
+# 🧠 ArkAssistant - Hierarchical Multi-Agent System
 
-ArkAssistant is a multi-functional AI agent built with [`smolagents`](https://github.com/huggingface/smolagents) for Unit 1 of the [Hugging Face Agents Course](https://hf.co/learn/agents-course).
+**ArkAssistant** is an autonomous multi-agent system built with [`smolagents`](https://github.com/huggingface/smolagents) for the [Hugging Face AI Agents Course](https://hf.co/learn/agents-course) (Units 1 & 2).
 
-## 🛠️ Capabilities & Tools
+## 🏛️ System Architecture
 
-- 🔍 **Web Search**: Real-time web browsing via DuckDuckGo (`DuckDuckGoSearchTool`).
-- 📚 **Wikipedia Summary**: Fast encyclopedic lookups via Wikipedia REST API (`search_wikipedia`).
-- 🌦️ **Live Weather**: Current temperature and weather conditions worldwide (`get_weather`).
-- 🕒 **Timezone Checker**: Real-time local time calculations across IANA timezones (`get_current_time_in_timezone`).
-- 🎨 **Image Generation**: Generates images from text descriptions via Hugging Face Hub (`agents-course/text-to-image`).
-- 💡 **Code-based Reasoning**: Executes code safely in a sandboxed Python interpreter with `CodeAgent`.
+ArkAssistant uses a **Hierarchical Multi-Agent** design where a senior manager orchestrates specialized worker agents:
+
+```
+                  ┌────────────────────────┐
+                  │  ArkAssistant_Manager  │
+                  └───────────┬────────────┘
+                              │
+             ┌────────────────┴────────────────┐
+             ▼                                 ▼
+   ┌──────────────────┐              ┌──────────────────┐
+   │  web_researcher  │              │local_info_agent  │
+   │ - DuckDuckGo     │              │ - Live Weather   │
+   │ - Wikipedia API  │              │ - Timezone Clock │
+   └──────────────────┘              └──────────────────┘
+```
+
+- 👔 **`ArkAssistant_Manager`**: Deconstructs user requests, delegates sub-tasks to specialists, and synthesizes the final response.
+- 🔍 **`web_researcher`**: Specialist agent equipped with DuckDuckGo web search and Wikipedia REST API lookups.
+- 🌦️ **`local_info_specialist`**: Specialist agent equipped with worldwide live weather (wttr.in) and IANA timezone time conversion.
+- 🎨 **Image Generation**: Manager tool capable of text-to-image generation via Hugging Face Hub.
 
 ## ⚙️ Configuration & Secrets