Skip to content

parth-shinge/FinSentry

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

7 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ›‘οΈ FinSentry

Explainable Financial Crime Investigation Platform

Python FastAPI React TypeScript Graph Analytics Explainability Tests

A financial crime investigation platform for detecting suspicious transactions, analyzing financial networks, and generating regulatory reports.

FinSentry converts raw transaction datasets into structured investigation intelligence using fraud detection models, explainable analytics, graph-based investigation tools, and automated SAR report generation.


🧠 Overview

Financial institutions process millions of transactions daily, making fraud investigation and AML monitoring difficult.

FinSentry provides a complete investigation pipeline that allows analysts to:

β€’ detect suspicious transactions β€’ understand fraud model explanations β€’ explore transaction networks visually β€’ identify money laundering patterns β€’ build investigation cases β€’ generate Suspicious Activity Reports (SAR)

The platform provides an interactive investigation dashboard for financial crime analysts.


πŸ“Έ Screenshots

Dashboard

Dashboard

The dashboard allows investigators to upload transaction datasets and run the full investigation pipeline.


Investigation Graph

Investigation

The investigation page visualizes the transaction network, allowing analysts to explore entity relationships, suspicious flows, and risk scores.


SAR Report

Report

Generated SAR reports summarize suspicious activity, evidence, and regulatory insights.


πŸ— System Architecture

Transaction Dataset
        β”‚
        β–Ό
Fraud Detection
(Isolation Forest + Random Forest)
        β”‚
        β–Ό
Explainability
(SHAP Feature Attribution)
        β”‚
        β–Ό
Graph Intelligence
(NetworkX Transaction Graph)
        β”‚
        β–Ό
AML Pattern Detection
        β”‚
        β–Ό
Case Builder
        β”‚
        β–Ό
Investigation Narrative
        β”‚
        β–Ό
SAR Generator
        β”‚
        β–Ό
Compliance Validator
        β”‚
        β–Ό
Investigation Dashboard

✨ Core Features

πŸ” Fraud Detection

Transactions are analyzed using machine learning models:

β€’ Isolation Forest β€’ Random Forest

Each transaction receives a fraud probability score and risk classification.


🧠 Explainable Risk Analysis

FinSentry integrates SHAP to explain fraud predictions.

Investigators can view:

β€’ feature importance β€’ anomaly drivers β€’ entity-level risk explanations

This enables transparent and auditable decision-making.


πŸ•Έ Graph-Based Investigation

Financial crime often occurs across networks of transactions.

FinSentry builds a transaction graph where:

β€’ nodes represent entities β€’ edges represent financial transfers

Graph analytics include:

β€’ degree centrality β€’ PageRank β€’ community detection β€’ cycle detection β€’ suspicious transfer chains


🚨 AML Pattern Detection

The system automatically detects common AML typologies:

β€’ structuring β€’ layering β€’ round-tripping β€’ rapid transfers β€’ shell company clusters

Each detection includes investigator-friendly explanations.


πŸ—‚ Case Builder

Suspicious transactions are grouped into investigation cases containing:

β€’ involved entities β€’ suspicious transactions β€’ AML patterns detected β€’ evidence and indicators β€’ narrative explanations


πŸ“‘ SAR Report Generation

FinSentry generates Suspicious Activity Reports automatically.

Reports include:

β€’ suspicious activity description β€’ transaction evidence β€’ risk assessment β€’ jurisdiction analysis β€’ entities involved

Generated SAR reports are stored and retrievable.


πŸ’Ύ SAR Report Storage

Available endpoints:

Endpoint Description
GET /sar/list List stored SAR reports
GET /sar/{report_id} Retrieve SAR report

This allows investigators to review historical reports.


πŸ–₯ Investigation Dashboard

Upload Panel

Upload transaction datasets.

Fraud Table

Displays suspicious transactions with fraud scores.

Graph Investigation

Interactive network graph showing suspicious transaction flows.

Entity Profile

Shows entity risk metrics and connected entities.

Case Viewer

Displays investigation cases and AML patterns.

SAR Viewer

Generate and browse SAR reports.


βš™οΈ Tech Stack

Backend

Python FastAPI Pydantic scikit-learn SHAP NetworkX SQLAlchemy


Frontend

React TypeScript Vite TailwindCSS react-force-graph


Testing

pytest

326 automated tests


πŸ“‘ API Endpoints

Endpoint Description
POST /pipeline/run Run investigation pipeline
GET /case/{case_id} Retrieve investigation case
GET /timeline/{case_id} Investigation timeline
GET /graph/{entity_id} Graph metrics for entity
GET /entity/{entity_id} Entity investigation profile
POST /sar/generate Generate SAR report
GET /sar/list List stored SAR reports
GET /sar/{report_id} Retrieve SAR report

πŸ“‚ Project Structure

FinSentry/
β”‚
β”œβ”€β”€ agents/
β”œβ”€β”€ aml_patterns/
β”œβ”€β”€ case_builder/
β”œβ”€β”€ compliance_validator/
β”œβ”€β”€ explainability/
β”œβ”€β”€ fraud_detection/
β”œβ”€β”€ graph_engine/
β”œβ”€β”€ graph_rag/
β”œβ”€β”€ ingestion/
β”œβ”€β”€ investigation_narrative/
β”œβ”€β”€ sar_generator/
β”œβ”€β”€ api/
β”‚
β”œβ”€β”€ frontend/
β”‚
β”œβ”€β”€ data/
β”‚   └── sample_data_transactions.csv
β”‚
β”œβ”€β”€ screenshots/
β”‚   β”œβ”€β”€ dashboard.png
β”‚   β”œβ”€β”€ investigation.png
β”‚   └── report.png
β”‚
β”œβ”€β”€ tests/
└── requirements.txt

βš™οΈ Installation

Clone the repository

git clone https://github.com/parth-shinge/FinSentry.git
cd FinSentry

Create virtual environment

python -m venv venv

Activate environment

Mac/Linux

source venv/bin/activate

Windows

venv\Scripts\activate

Install dependencies

pip install -r requirements.txt

▢️ Running the Backend

Start the API server

uvicorn api.main:app --reload

Backend runs at

http://localhost:8000

API docs

http://localhost:8000/docs

▢️ Running the Frontend

cd frontend
npm install
npm run dev

Frontend runs at

http://localhost:5173

πŸ§ͺ Demo Workflow

1. Upload sample transaction dataset
2. Run investigation pipeline
3. Explore transaction graph
4. Investigate entities and cases
5. Generate SAR report
6. Review stored SAR reports

⭐ Highlights

βœ” Explainable fraud detection βœ” Graph-based AML investigation βœ” Automated case generation βœ” SAR report generation and storage βœ” Interactive investigation dashboard


🏁 Conclusion

FinSentry demonstrates how fraud detection models, explainable analytics, and graph-based investigation tools can be integrated into a unified system for financial crime analysis and AML compliance.

The platform enables investigators to identify suspicious networks, build investigation cases, and generate regulatory reports efficiently.

About

Financial crime investigation platform that detects suspicious transactions, analyzes transaction networks using graph analytics, and generates Suspicious Activity Reports (SAR) through an interactive investigation dashboard.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors