File size: 2,399 Bytes
dd81f41
307aecf
 
3fcf7a5
 
dd81f41
3fcf7a5
dd81f41
 
3fcf7a5
 
 
307aecf
 
3fcf7a5
 
dd81f41
 
307aecf
3fcf7a5
307aecf
3fcf7a5
307aecf
3fcf7a5
307aecf
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
3fcf7a5
 
 
 
 
 
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
---
title: ArkAssistant Multi-Agent System
emoji: 🧠
colorFrom: indigo
colorTo: purple
sdk: gradio
sdk_version: 5.23.1
app_file: app.py
pinned: false
tags:
- smolagents
- agent
- multi-agent
- hierarchical-agents
- tool
- agent-course
---

# 🧠 ArkAssistant - Hierarchical Multi-Agent System

**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).

## πŸ›οΈ System Architecture

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

To ensure the agent has full access to the Hugging Face serverless inference API and image generation tool:
1. Go to **Settings** -> **Variables and Secrets** in this Space.
2. Add a new secret named `HF_TOKEN` with your Hugging Face User Access Token (with inference permissions).