README.md

metadata

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 for the Hugging Face AI 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).