Skip to content

About

FinSight AI is a full-stack financial intelligence platform that leverages Google Gemini AI to analyze financial data, assess portfolio risks, and generate actionable insights through an interactive dashboard.

Resources

Code of conduct

Contributing

Stars

0 stars

Watchers

0 watching

Forks

ย 
ย 

Latest commit

ย 

History

916 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

AI-powered BFSI intelligence platform for financial document analysis, risk assessment, and automated business insights.

FinSight AI is an AI-assisted financial intelligence platform built for the Banking, Financial Services, and Insurance (BFSI) domain. It enables organizations to upload financial documents, extract meaningful insights, evaluate portfolio risks, and generate structured reports using AI-driven analysis.

The platform combines modern web technologies with generative AI to transform complex financial documents into actionable intelligence for analysts, decision-makers, and financial teams.


๐Ÿš€ Key Features

๐Ÿ“„ Secure Document Intelligence

  • Secure financial document ingestion workflow
  • Upload and analyze reports, credit reviews, and portfolio summaries
  • Cloud-based document storage with Firebase Storage

๐Ÿค– AI-Powered Financial Analysis

  • Automated document understanding using Hugging Face Inference (Llama-3.3-70B-Instruct)
  • Financial metric extraction from unstructured documents
  • AI-generated executive summaries
  • Intelligent insight generation

๐Ÿ“Š Risk & Portfolio Analytics

  • Portfolio risk assessment
  • Sentiment analysis of financial reports
  • Structured financial interpretation
  • Monitoring dashboard for financial insights

๐Ÿ” Authentication & Data Management

  • Firebase Authentication for secure user access
  • Cloud Firestore for persistent application data
  • Role-ready architecture for future enterprise expansion

๐ŸŽจ Modern User Experience

  • Responsive operational dashboard
  • Dark-mode interface optimized for financial workflows
  • Clean and intuitive BFSI-focused UI

๐Ÿ—๏ธ System Architecture

User
 |
 | Upload Financial Documents
 |
Frontend (React + TypeScript + TailwindCSS)
 |
Backend API (Node.js + Express)
 |
AI Processing Layer (Hugging Face Inference)
 |
Firebase Services
 โ”œโ”€โ”€ Authentication
 โ”œโ”€โ”€ Cloud Firestore
 โ””โ”€โ”€ Firebase Storage

CI

๐Ÿ› ๏ธ Tech Stack

Frontend

  • React
  • TypeScript
  • TailwindCSS
  • Vite

Backend

  • Node.js
  • Express.js

AI Integration

  • Hugging Face Inference API (Llama-3.3-70B-Instruct)

Database & Cloud Infrastructure

  • Firebase Authentication
  • Cloud Firestore
  • Firebase Storage

Development & Deployment

  • Docker
  • Environment-based configuration

โš™๏ธ Local Development Setup

Prerequisites

Before running the project, make sure you have:

  • Node.js 18+
  • Firebase Project
  • Hugging Face Inference API Key
  • Docker (optional)

Installation

1. Clone the Repository

git clone <repository-url>

cd finsight-ai

2. Install Dependencies

npm install

3. Configure Environment Variables

Create a .env file in the project root and add:

HUGGINGFACE_API_KEY=your_huggingface_inference_api_key

FIREBASE_API_KEY=your_firebase_api_key
FIREBASE_AUTH_DOMAIN=your_project.firebaseapp.com
FIREBASE_PROJECT_ID=your_project_id
FIREBASE_STORAGE_BUCKET=your_storage_bucket

๐Ÿณ Docker Setup

Build Docker Image

docker build -t finsight-ai .

Run Container

docker run -d --env-file .env -p 3001:3001 finsight-ai

The application will be available at:

http://localhost:3001

๐Ÿ“‚ Project Highlights

  • AI-driven BFSI document intelligence
  • Generative AI powered financial analysis
  • Secure cloud-based document workflows
  • Scalable Firebase architecture
  • Modern responsive dashboard experience

๐Ÿ”ฎ Future Enhancements

  • Advanced portfolio prediction models
  • Real-time financial market integrations
  • Multi-user enterprise collaboration
  • Automated compliance reporting
  • AI chatbot for financial queries
  • Advanced analytics visualization

CI/CD

All pull requests run three automated checks via GitHub Actions:

Check Command Purpose
TypeScript npx tsc --noEmit Catches type errors before merge
Lint npm run lint Enforces code style rules
Build npm run build Verifies Vite build succeeds

Adding secrets for the build step

Maintainers: add these secrets under Settings โ†’ Secrets and variables โ†’ Actions:


๐Ÿค Contributing

Contributions are welcome! Please read the contribution guide before opening an issue or pull request. It covers local setup, environment variables, branch naming, commit conventions, testing, and review expectations.

  1. Fork the repository
  2. Create a feature branch
git checkout -b feature/new-feature
  1. Commit your changes
git commit -m "Add new feature"
  1. Push your branch
git push origin feature/new-feature
  1. Create a Pull Request

๐Ÿ“œ License

This project is licensed under the MIT License.


โญ Support

If you find this project useful, consider giving it a star โญ on GitHub.

About

FinSight AI is a full-stack financial intelligence platform that leverages Google Gemini AI to analyze financial data, assess portfolio risks, and generate actionable insights through an interactive dashboard.

Resources

Code of conduct

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages