whatisgithub

What is supportiq?

adii0906/supportiq — explained in plain English

Analysis updated 2026-05-18

1JavaScriptAudience · developerComplexity · 3/5Setup · moderate

In one sentence

An AI support tool that detects a customer's language and replies with a lip-synced avatar video speaking their language, built in 24 hours for a hackathon.

Mindmap

mindmap
  root((SupportIQ))
    What it does
      Detect customer language
      Write empathetic reply
      Generate avatar video
    Tech stack
      React
      FastAPI
      LangGraph
      HeyGen API
    Use cases
      Multilingual support demo
      Hackathon agent prototype
      Sentiment based routing
    Pipeline
      Detect
      Route
      Script
      Generate
      Deliver

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Prototype a multilingual customer support flow that responds with video instead of text.

USE CASE 2

Learn how to chain a language model, routing logic, and an avatar video API into one pipeline.

USE CASE 3

Demonstrate an AI hackathon agent that detects sentiment and routes non-English or angry messages differently.

USE CASE 4

Explore using HeyGen's avatar and lipsync tools inside a LangGraph agent.

What is it built with?

ReactViteFastAPIPythonLangGraphHeyGen API

How does it compare?

adii0906/supportiqacip/slack-claude-agentadrian7411374113/agent-team-brain
Stars111
LanguageJavaScriptJavaScriptJavaScript
Setup difficultymoderatemoderatemoderate
Complexity3/53/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires free-tier API keys from Groq and HeyGen before it will run.

The README does not state a license for the project.

So what is it?

SupportIQ is a customer support tool that replies to customers in their own language, delivered as a short video of a talking avatar instead of plain text. The idea it is built around: when a customer writes in Spanish, Hindi, French, Arabic, Japanese, or another language and gets a reply in English, they often feel unheard and leave. SupportIQ tries to close that gap by detecting the language a customer wrote in, writing an empathetic reply in that same language, and generating a lip-synced avatar video of that reply. The system runs as a five-step automated pipeline. First, a language model detects the customer's language, emotional tone, and the type of request. Second, a routing step decides whether to answer with a video avatar, used for non-English messages or angry customers, or with a plain text reply for simple English messages. Third, the pipeline writes an empathetic response in the customer's own language. Fourth, the HeyGen platform renders a video of an avatar speaking that response with matching lip movement. Fifth, the finished video streams back to the customer, with the whole process taking about ten seconds. Under the hood, the frontend is built with React and Vite, the backend runs on FastAPI and Python, and LangGraph with LangChain coordinates the five agent steps. The language understanding and reply writing run on Groq's LLaMA 3.3 70B model, while the avatar video itself is generated through the HeyGen API. Running the project locally needs two API keys, one from Groq and one from HeyGen, both of which offer free tiers. The project was built during a 24-hour HeyGen Hackathon in 2026, and the README frames it as a proof of concept aimed at that competition's agent track rather than a finished commercial product.

Copy-paste prompts

Prompt 1
Explain how SupportIQ's five-step pipeline goes from a customer message to a lip-synced avatar video reply.
Prompt 2
Help me set the GROQ_API_KEY and HEYGEN_API_KEY environment variables to run SupportIQ locally.
Prompt 3
Walk me through the routing logic that decides between a video avatar reply and a plain text reply in SupportIQ.
Prompt 4
Show me how LangGraph and LangChain are used to orchestrate SupportIQ's detect, route, script, and generate steps.

Frequently asked questions

What is supportiq?

An AI support tool that detects a customer's language and replies with a lip-synced avatar video speaking their language, built in 24 hours for a hackathon.

What language is supportiq written in?

Mainly JavaScript. The stack also includes React, Vite, FastAPI.

What license does supportiq use?

The README does not state a license for the project.

How hard is supportiq to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is supportiq for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.