git404hub

what is ai_fraud_detection_chatbot fr?

prakhar2295/ai_fraud_detection_chatbot — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 4/5Setup · hard

tl;dr

Voice AI pipeline for banking fraud detection that transcribes calls, runs them through a local LLM and LangGraph workflow, then replies via Piper TTS.

vibe map

mindmap
  root((FraudVoiceAI))
    Inputs
      WebSocket PCM16 audio
      Microphone stream
      Session state
    Outputs
      Transcript updates
      Fraud risk score
      Spoken AI reply
    Use Cases
      Detect scam calls
      Voice agent demo
      Persistent fraud memory
    Tech Stack
      Python
      LangGraph
      Ollama
      Piper
      ChromaDB

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 voice agent that flags banking fraud during a call

VIBE 2

Build a streaming STT to LLM to TTS pipeline with LangGraph

VIBE 3

Store fraud patterns in ChromaDB for cross-session retrieval

what's the stack?

PythonFastAPILangGraphOllamaPiperChromaDBUvicorn

how it stacks up fr

prakhar2295/ai_fraud_detection_chatbot0xhassaan/nn-from-scratch3ks/embedoc
Stars00
LanguagePythonPythonPython
Last pushed2023-06-08
MaintenanceDormant
Setup difficultyhardmoderatehard
Complexity4/54/51/5
Audiencedeveloperdeveloperdeveloper

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

how do i run it?

Difficulty · hard time til it works · 1h+

Needs Python 3.14, a running Ollama instance, and a Piper CLI on PATH for real voice output, falls back to placeholder audio otherwise.

in plain english

This repository contains a Banking Fraud Detection Voice AI system written in Python. The aim, as described in the README, is to take a voice conversation, transcribe it, run it through an AI model to look for signs of banking fraud, and reply back to the caller using a synthesized voice. The whole thing is split into multiple phases, each with its own backend README, and the main page focuses on Phase 4 and Phase 7. In Phase 1, the project began as an offline pipeline: a WAV audio file was passed through speech-to-text, the text was sent to a local large language model running in Ollama, and the model produced a fraud reasoning response. Phase 2 added microphone input and near-realtime streaming. Phase 3 introduced a graph-based workflow using LangGraph, which is a library for orchestrating steps in a deterministic order, covering intent detection, fraud analysis, risk scoring, and memory. Phase 4, the main focus of this README, adds spoken replies. A new TTS layer based on Piper, an open-source text-to-speech engine, turns the AI's response into audio. There is a queue-safe playback manager, turn management to track who is speaking, and the start of interruption support so the user can talk over the bot. A new conversation coordinator wires together speech-to-text, the LangGraph workflow, and the TTS playback. Phase 7 adds long-term memory and vector-based retrieval of past fraud patterns using ChromaDB, with a fallback to an in-memory store when ChromaDB is not installed. The README documents how to install dependencies from requirements.txt, run the server with Uvicorn on port 8000, connect a WebSocket client at /ws/voice/<session_id>, and send PCM16 audio frames along with control messages like flush, stop, and ping.

prompts (copy fr)

prompt 1
Walk me through setting up Ollama and Piper to run this fraud chatbot locally
prompt 2
Show me how ConversationCoordinator wires STT, LangGraph and TTS together
prompt 3
Add a new LangGraph node that checks the caller against a deny list
prompt 4
Write a small Python WebSocket client that streams a WAV file to /ws/voice and prints responses

Frequently asked questions

what is ai_fraud_detection_chatbot fr?

Voice AI pipeline for banking fraud detection that transcribes calls, runs them through a local LLM and LangGraph workflow, then replies via Piper TTS.

What language is ai_fraud_detection_chatbot written in?

Mainly Python. The stack also includes Python, FastAPI, LangGraph.

How hard is ai_fraud_detection_chatbot to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is ai_fraud_detection_chatbot for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.