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