Skip to content

darshons/MBAi

Repository files navigation

AgentFlow - Visual AI Workflow Builder

AgentFlow Next.js TypeScript

AgentFlow is a visual platform that makes multi-agent AI orchestration accessible to everyone. Design agent workflows using an intuitive org-chart interfaceβ€”no coding required.

🎯 Problem Statement

Companies struggle to coordinate multiple AI agents for complex workflows. Traditional solutions require:

  • Complex code and technical expertise
  • Manual orchestration between agents
  • Difficult-to-visualize agent hierarchies
  • Time-consuming setup and iteration

πŸ’‘ Our Solution

AgentFlow provides a visual, drag-and-drop interface where users can:

  • Create agents with custom instructions (like employees in an org chart)
  • Define hierarchies by drawing arrows between agents
  • Execute workflows by passing data through the visual pipeline
  • See results in real-time with visual feedback

✨ Features

Core Functionality

  • 🎨 Visual Canvas - Drag-and-drop agent creation and positioning
  • πŸ”— Connection System - Draw arrows to define agent hierarchy
  • πŸ€– Claude Integration - Each agent powered by Claude 3.5 Sonnet
  • ⚑ Real-time Execution - Watch your workflow execute step-by-step
  • πŸ“Š Visual Feedback - Active agent highlighting and status indicators

Agent Types

  • Intake Agents - Receive and categorize initial requests
  • Processing Agents - Perform main tasks and transformations
  • Response Agents - Format and deliver final outputs

Pre-built Templates

  • πŸ“‹ Customer Support Workflow - Automated ticket triage and resolution
  • More templates coming soon

πŸš€ Getting Started

Prerequisites

Installation

  1. Clone the repository

    git clone https://github.com/yourusername/agentflow.git
    cd agentflow
  2. Install dependencies

    npm install
  3. Configure environment variables

    cp .env.example .env.local

    Edit .env.local and add your Anthropic API key:

    ANTHROPIC_API_KEY=your_api_key_here
    
  4. Run the development server

    npm run dev
  5. Open your browser Navigate to http://localhost:3000

πŸ“– How to Use

Quick Start

  1. Load a Template - Click "πŸ“‹ Load Template" to see an example workflow
  2. Add Input - Enter a test query in the Execution Panel
  3. Run Workflow - Click "▢️ Run Workflow" to see it in action

Creating Your Own Workflow

  1. Create Agents

    • Click "+ Create Agent"
    • Give it a name (e.g., "Email Classifier")
    • Choose agent type (Intake, Processing, or Response)
    • Write instructions for what the agent should do
  2. Connect Agents

    • Drag from the right handle of one agent to the left handle of another
    • This defines the flow direction
  3. Test Your Workflow

    • Enter a test input in the Execution Panel
    • Click "Run Workflow"
    • Watch as each agent processes the data in sequence

πŸ—οΈ Technical Architecture

Tech Stack

  • Frontend: Next.js 16 + React + TypeScript
  • UI Components: React Flow (visual canvas), Tailwind CSS
  • State Management: Zustand
  • AI Integration: Anthropic Claude 3.5 Sonnet API
  • Deployment: Vercel

Key Components

app/
β”œβ”€β”€ api/execute/          # API endpoint for workflow execution
β”œβ”€β”€ layout.tsx            # Root layout with metadata
└── page.tsx              # Main application page

components/
β”œβ”€β”€ FlowCanvas.tsx        # React Flow canvas container
β”œβ”€β”€ AgentNode.tsx         # Custom node component for agents
β”œβ”€β”€ AgentModal.tsx        # Agent creation/editing modal
└── ExecutionPanel.tsx    # Workflow execution interface

store/
└── useFlowStore.ts       # Zustand state management

types/
└── index.ts              # TypeScript type definitions

Workflow Execution Flow

  1. User Input β†’ Enters query in Execution Panel
  2. Topological Sort β†’ Determines agent execution order based on connections
  3. Sequential Processing β†’ Each agent:
    • Receives context from previous agent (or initial input)
    • Calls Claude API with its specific instructions
    • Returns output to next agent
  4. Real-time Updates β†’ UI shows active agent and results as they come in
  5. Final Output β†’ Last agent's response shown to user

🎨 Use Cases

Customer Support

  • Intake Agent: Categorizes tickets (billing, technical, general)
  • Processing Agent: Provides solutions or escalation recommendations
  • Response Agent: Formats empathetic customer-facing response

HR Onboarding

  • Intake Agent: Analyzes new hire information
  • Processing Agent: Generates onboarding checklist
  • Response Agent: Creates welcome email

Sales Lead Qualification

  • Intake Agent: Extracts lead information
  • Processing Agent: Scores and qualifies lead
  • Response Agent: Generates personalized outreach

🌟 Why AgentFlow Wins

Impact & Relevance

  • βœ… Reduces agent setup time from hours to minutes
  • βœ… Makes AI workflows accessible to non-technical teams
  • βœ… Solves real coordination challenges companies face

Creativity

  • βœ… First visual org-chart interface for AI agents
  • βœ… Intuitive business metaphor (employees β†’ agents)
  • βœ… Makes complex AI orchestration simple

Best Use of Claude

  • βœ… Multi-agent architecture powered by Claude 3.5 Sonnet
  • βœ… Each agent maintains context through conversation
  • βœ… Demonstrates Claude's versatility across different roles

🚒 Deployment

Deploy to Vercel (Recommended)

  1. Push to GitHub

    git add .
    git commit -m "Initial commit"
    git push origin main
  2. Deploy to Vercel

    • Go to vercel.com
    • Import your GitHub repository
    • Add environment variable: ANTHROPIC_API_KEY
    • Click "Deploy"
  3. Done! Your app is now live

🀝 Contributing

We welcome contributions! Here's how:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

πŸ“ License

This project is built for the Claude Builder Club x ACT Rice Hackathon (Nov 8-9, 2025).

πŸ™ Acknowledgments

  • Anthropic - For Claude AI and the hackathon opportunity
  • React Flow - For the excellent flowchart library
  • Vercel - For seamless deployment

πŸ“§ Contact

Built with ❀️ for the Claude Builder Club Hackathon


Made with Claude AI πŸ€–

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages