WanIrfan/Witcher3_Swarm_Agents

❄️ Skellige Oracle — Multi-Agent Witcher 3 Expert

A Swarm-based AI system that uses Google Gemini and Multi-Agent Routing to answer complex questions about The Witcher 3: Wild Hunt.

🧠 How It Works

The system uses a Swarm Architecture with a semantic router that intelligently dispatches queries to one of three specialized agents:

1. 1.📜 Lore Master: Specializes in story, choices, character backgrounds, and endings.
2. 2.⚔️ Combat Specialist: Focuses on builds, enemy weaknesses, gear stats, and alchemy.
3. 3.💰 Loot Expert: Handles exploration, hidden treasures, crafting diagrams, and economy.
4. 4.🔀 The Router: A dedicated classifier agent that analyzes user intent to pick the perfect expert.

🛠️ Tech Stack

• —Python 3.10+
• —Swarms: For agent orchestration and routing.
• —Google Gemini (via API): The LLM brain (Gemini 1.5 Flash).
• —Gradio (v6.0+): Modern web interface with a custom "Skellige Ice" theme.

🚀 Setup & Run

1. Install Dependencies

pip install -r requirements.txt

2. Set API Key

Create a .env file in the root directory and add your Google Gemini key:

GEMINIAPIKEY=yourkeyhere

3. Run the App

python app.py Open your browser to the local URL (usually http://127.0.0.1:7860).