🧙‍♂️ ADK Workflow Wizard - Agentic n8n Workflow Generator

A sophisticated multi-agent system built with Google's Agent Development Kit (ADK) that automatically generates production-ready n8n workflows from natural language requirements. Powered by Context7 MCP for real-time n8n documentation verification.

Overview

• Multi-Agent Architecture: Specialized AI agents work in parallel to plan, develop, and document n8n workflows with real-time Context7 verification
• Production-Ready Output: Generates valid n8n JSON workflows and comprehensive setup guides ready for immediate deployment
• Intelligent Planning: Iterative conversation between Router and Planner agents ensures optimal workflow design before implementation
• Self-Improving System: Built-in Opik integration provides automated evaluation, prompt optimization, and continuous performance enhancement

Technology Stack

• LLM Model: Gemini-2.5-flash through Openrouter
• Framework: Google Agent Development Kit (ADK)
• MCP: Context7 MCP for real-time n8n verification
• Observability: Opik for tracing, evaluation, and optimization

Features

• Multi-Agent Architecture: Specialized AI agents working in parallel for optimal workflow generation
• Intelligent Planning: Context7-powered workflow planning with real-time n8n node verification
• Parallel Development: Simultaneous JSON generation and documentation creation
• Auto-Documentation: User-friendly setup guides generated automatically
• Production-Ready: Valid n8n JSON workflows ready for immediate import
• Observability & Evaluation: Built-in Opik tracing for monitoring, debugging, and system evaluation

Architecture

graph TD
    A["👤 User Requirements"] --> B["🤖 n8n Workflow Router"]
    B --> C["🤖 Workflow Planner"]
    C --> B
    C --> D["🔍 Context7 MCP"]
    D --> C
    B --> E["🤖 Developer Agent Team"]
    E --> F["🤖 Trigger Generator"]
    E --> G["🤖 Processing Generator"]
    E --> H["🤖 Output Generator"]
    
    %% Developer agents connect to their own MCP instance
    F --> D2["🔍 Context7 MCP"]
    G --> D2
    H --> D2
    
    F --> I["🤖 Workflow Compiler"]
    G --> I
    H --> I
    B --> J["🤖 Documentation Agent"]
    I --> K["✅ Final JSON n8n Workflow"]
    J --> L["📖 Setup Guide.md"]
    K --> M["🎁 Complete Package"]
    L --> M
    
    classDef agent fill:#e1f5fe,stroke:#01579b,stroke-width:2px,color:#000
    classDef mcp fill:#f3e5f5,stroke:#4a148c,stroke-width:2px,color:#000
    classDef output fill:#e8f5e8,stroke:#1b5e20,stroke-width:2px,color:#000
    classDef user fill:#fff3e0,stroke:#e65100,stroke-width:2px,color:#000
    
    class B,C,E,F,G,H,I,J agent
    class D,D2 mcp
    class K,L,M output
    class A user

Loading

Installation

Prerequisites

• Python 3.8+
• OpenRouter API KEY - Get your API key from OpenRouter
• Context7 API key - Sign up for free Context7 access

Setup

1. Clone the repository

   git clone https://github.com/Folken2/adk-wizard.git
   cd adk-wizard

2. Install dependencies

   pip install -r requirements.txt

3. Environment configuration

   Create a .env file in the agent folder:

   CONTEXT7_API_KEY=your_context7_api_key_here
   OPENROUTER_API_KEY=your_google_api_key_here

4. Run the application with interactive UI

   adk web

Agent Specializations

Workflow Planner

• Purpose: Technical architect for n8n workflows
• Capabilities: Context7-powered node verification, optimal flow design
• Output: Detailed technical workflow plans

Developer Agent Team

• Trigger Generator: Creates trigger and data collection nodes
• Processing Generator: Builds transformation and logic nodes
• Output Generator: Handles notifications and error handling
• Compiler: Merges all sections into final workflow

Documentation Agent

• Purpose: Creates user-friendly setup guides
• Capabilities: Beginner-friendly instructions, troubleshooting
• Output: Complete documentation package

Agent Customization

Modify agent instructions in:

• agent/sub_agent/workflow_planner.py
• agent/sub_agent/developer_agent.py
• agent/sub_agent/documentation_agent.py

Monitoring & Observability

Built-in Opik integration provides comprehensive agentic system management:

• Real-Time Tracing: Complete agent behavior monitoring with detailed execution traces and multi-agent workflow visualization
• Automated Evaluations: Performance assessment using relevance and hallucination detection metrics with continuous quality monitoring
• Advanced Analytics: Performance metrics, error tracking, success rate analysis, and data-driven insights for system improvement

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Google ADK team for the powerful agent framework
• Openrouter for the best LLM multi-provider service
• Context7 for comprehensive up-to-date n8n documentation
• n8n community for inspiration and feedback
• Opik for the open-source observability tool

---

Built using Google ADK, Context7 MCP, and modern AI technologies.