Spaces:
Running on Zero
Running on Zero
| 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). | |