BillyGPT is a powerful, modular Intelligent Document Processing (IDP) platform designed to handle complex workflows including PDF uploads, RAG (Retrieval-Augmented Generation) chat, structured data extraction, and deep data analysis.
It is split into three main components: a user-facing frontend, a comprehensive admin dashboard, and a robust FastAPI backend.
- Conversational AI & RAG Chat: Chat directly with your documents to extract insights effortlessly.
- Intelligent Document Processing (IDP): Automated extraction of structured data from complex PDFs using state-of-the-art vision and language models.
- Data Analysis Agent: Leverage built-in AI agents to analyze, summarize, and chart data points.
- Admin Dashboard: Full administrative control over users, documents, extraction templates, and system metrics.
- Artifacts Generation: Save and manage extracted data artifacts securely.
Interact with BillyGPT seamlessly through an intuitive conversational interface.

Perform deep dives into your database (NCUA database here) with the built-in Data Analysis Agent.

Extract, manage, and view structured artifacts derived from unstructured documents.

A dedicated environment for administrators to monitor platform usage and manage configurations.

Frontend & Admin Dashboard:
- Next.js 16 (App Router & Turbopack)
- React 19
- Tailwind CSS 4
- Radix UI & Recharts for beautiful, accessible components and data visualization.
Backend:
- FastAPI (Python)
- ChromaDB for Vector Search & RAG
- Tesseract OCR for Optical Character Recognition
- SQL Database integration for user/report management
- Node.js (v18+ recommended)
- Python 3.10+
- Optional: Tesseract installed on your system for advanced OCR capabilities.
git clone https://github.com/your-username/BillyGPT.git
cd BillyGPTcd Backend
pip install -r requirements.txt # (Ensure your virtual environment is active)
python run.pyThe backend will be running at http://localhost:8000.
cd Frontend
npm install
npm run devThe frontend will be running at http://localhost:3000.
cd AdminFrontend
npm install
npm run devThe admin dashboard will be running at http://localhost:3001.
This project is proprietary. Refer to the LICENSE file for more details.