← Back to projects
Hackathon Project

Smart KYC Assistant

Multimodal document intelligence workflow

React/FastAPI KYC workflow using GPT-4o Vision for document extraction, classification-style review support, face verification analysis, persistence, and contextual assistance.

AI/MLFull-StackBackend
Status
Prototype
Year
2026
Role / Context
Hackathon product engineering project

AI/ML · Full-Stack

Smart KYC Assistant

React / Vite / Tailwind / Zustand

Overview

Smart KYC Assistant is a full-stack hackathon project for AI-assisted identity verification. The frontend uses React, Vite, Tailwind, Zustand, React Hook Form, Zod, Framer Motion, and Axios. The backend uses FastAPI, async SQLAlchemy, PostgreSQL/SQLite support, Alembic, OpenAI, Pillow/OpenCV, tests, and service layers for OCR/document extraction, KYC records, face verification analysis, and chat assistance.

Problem

Traditional KYC workflows create manual data-entry friction and review overhead when users submit identity documents as images.

Solution

Use GPT-4o Vision and backend orchestration to transform document uploads into structured identity data, persist KYC state, support face-verification analysis, and provide a context-aware assistant through a React onboarding flow.

Engineering Highlights

  • GPT-4o Vision integration is present in OCR/document extraction and face-analysis service code.
  • FastAPI endpoints separate OCR, KYC, face verification, and chat workflows.
  • Async SQLAlchemy models persist KYC records, documents, chat messages, and face verification data.
  • React frontend structures upload, OCR processing, KYC form/status/tracking, face verification, and chatbot pages.
  • Tests patch OpenAI calls and exercise KYC/chat backend behavior without claiming production biometric certification.

Architecture

  1. 01React KYC flow
  2. 02Upload/API service
  3. 03FastAPI OCR/KYC/face/chat endpoints
  4. 04OpenAI GPT-4o Vision services
  5. 05SQLAlchemy models
  6. 06PostgreSQL/SQLite

Technology

Frontend

ReactViteTailwind CSSZustandReact Hook FormZodFramer MotionAxios

Backend

FastAPIPythonasync SQLAlchemyPydanticservice/endpoints architecture

AI/ML

OpenAI APIGPT-4o Visionmultimodal document extractionface verification analysiscontext-aware chat

Data

PostgreSQLSQLite local databaseAlembic migrations

Testing

pytestOpenAI mocking in tests

Ownership / Context

Smart KYC Assistant is presented as a hackathon project. The portfolio describes repository-verified architecture and product scope without implying sole ownership of team work.

Screenshots / Assets