README.md

metadata

license: cc-by-nc-nd-4.0
title: CafeAgentX
sdk: gradio
emoji: 😻
colorFrom: gray
colorTo: green
pinned: true
thumbnail: >-
  https://cdn-uploads.huggingface.co/production/uploads/67e3c171b2c0b79ed2977a0d/4_PLlI6UsHjLMao9Ummls.png
short_description: an advanced AI-powered café assistant.
sdk_version: 5.38.0

SupportFlowX 🚀

Agent Orchestration Framework for Scalable, Modular Chatbots

🌐 Try the CafeAgentX on Hugging Face Spaces

Example Project: CafeAgentX ☕ – Café Assistant Demo

---

Overview

SupportFlowX is a flexible, agentic orchestration framework designed to build scalable, multi-agent AI assistants.
The core design enables easy integration, scaling, and replacement of domain-specific AI agents for any business scenario.
By orchestrating tasks between specialized agents, SupportFlowX minimizes bottlenecks and maximizes both reliability and maintainability.

CafeAgentX is provided as a working demo — a café chatbot that showcases agent collaboration for customer Q&A, menu, promotions, and database support.

---

✨ Key Features

• Orchestration-First: True agentic routing; intake agent delegates tasks to skill-specific agents.
• Highly Scalable: Add or swap agents and domains with minimal code changes.
• Reduce LLM Bottlenecks: Parallel and specialized task handling for better throughput.
• Production-Ready Demo: Café Assistant (CafeAgentX) demonstrates end-to-end deployment.
• Gradio UI: Easy, ready-to-use chat interface for fast prototyping or real-world service.

---

💡 Use Cases

SupportFlowX is not limited to cafés!

• Customer support (retail, banking, IT helpdesk, etc.)
• Booking & reservations
• HR or internal knowledge bots
• Medical, law, or domain-specific assistants
• … any scenario where orchestrated, scalable agents make sense.

Just swap out the agent modules and data!

---

🏗️ Architecture

The core logic is in core.py, which handles orchestration and routing between specialized agents.

• All main configuration is in config.py.
• Database files for both structured data and RAG are inside data/ and knowledge-base/.
• Each agent is modular and extensible (see AG00_*, AG01_*, ...).

Project Structure

- agents/         — Agent logic and wrappers
- assets/         — Images, knowledge base, raw data
- config/         — Configuration and agent registry
- database/       — SQLite DB and scripts
- rag/            — RAG system and embeddings
- ui/             — Gradio UI and themes
- workflows/      — Workflow graph and routing

---

🚀 Quick Start

1. Clone the repo

git clone https://github.com/your-username/supportflowx.git
cd supportflowx

2. Install dependencies

With pip

pip install -r requirements.txt

Or with uv (faster installs/locking)

uv pip install -r requirements.txt

3. Prepare data & API key

• Place your knowledge base (RAG documents) in /knowledge-base
• Place your sample DB as /data/database.db (or as configured)
• Get a Gemini API Key: https://makersuite.google.com/app/apikey (for Google Generative AI access)

4. Run the Demo App

python core.py

Then open the local Gradio UI in your browser!

---

🛠️ Customization & Scaling

• Add new skills: Create new agent modules (see AGXX_*.py), import and register in core.py.
• Change business logic: Tweak agent routing and orchestration logic as needed.
• Swap domains: Replace Café agents and data with your own (e.g. legal, retail, travel, etc.)
• Production Deployment: Wrap in FastAPI/ASGI and run with uvicorn for robust serving.

---

🖥️ Example: CafeAgentX

CafeAgentX is a demo café assistant built with SupportFlowX, featuring:

• Menu, promotions, and table info via RAG & database queries
• Natural language chat with easy UI
• Realistic, extensible agent collaboration (IntakeAgent → CafeBot & DBAgent → Aggregator → Response)

Workflow Diagram: (See attached diagram / image in repo for orchestration flow)

---

📦 Requirements

• Python 3.8+
• gradio
• langgraph
• typing-extensions
• operator
• langchain-google-genai
• pillow
• chromadb
• sentence-transformers
• PyPDF2
• pymupdf
• langchain-text-splitters
• python-dotenv
• pandas
• sqlite3

All listed in requirements.txt

---

🔒 License

Copyright (c) 2024 Thai

This project ("SupportFlowX" and all included examples such as "CafeAgentX") is released for educational, research, or internal evaluation purposes only.

• No commercial use.
• No redistribution, sublicensing, or use in proprietary software.
• Modification for private/learning purposes is allowed.
• For any public deployment, commercial use, or redistribution, please contact the author for explicit written permission.

All rights reserved.

⭐ Credits

Built with:

• LangGraph
• Gradio
• Google Generative AI

---

Ready to orchestrate your own AI support workflows? Fork SupportFlowX, swap the agents, and build the next smart support system — with no single-agent bottleneck!

---