git404hub

what is supportiq fr?

adii0906/supportiq — explained in plain English

Analysis updated 2026-05-18

1JavaScriptAudience · developerComplexity · 3/5Setup · moderate

tl;dr

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.

vibe map

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 make with this?

VIBE 1

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

VIBE 2

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

VIBE 3

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

VIBE 4

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

what's the stack?

ReactViteFastAPIPythonLangGraphHeyGen API

how it stacks up fr

adii0906/supportiqabhishek-kumar09/testacip/slack-claude-agent
Stars111
LanguageJavaScriptJavaScriptJavaScript
Last pushed2023-05-29
MaintenanceDormant
Setup difficultymoderateeasymoderate
Complexity3/51/53/5
Audiencedeveloperops devopsdeveloper

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

how do i run it?

Difficulty · moderate time til it works · 30min

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

The README does not state a license for the project.

in plain english

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.

prompts (copy fr)

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 fr?

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.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.