Skip to content

CaSh007s/cortex

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

44 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Cortex: Your AI-Powered Research Assistant

Analyze. Synthesize. Strategize.


A powerful RAG (Retrieval-Augmented Generation) platform fueled by Gemini 2.5 Flash and LangGraph.

Transforming static documents, PDFs, and web links into interactive, actionable research notebooks.


Live Demo YouTube Demo

Issues Forks Stars License


Desktop Landing Page Mobile Landing Page

⚡ Key Features

  • 🤖 Agentic Reasoning Loop: Powered by LangGraph, allowing the AI to "think" through complex queries rather than just retrieving text.
  • 🧠 Enterprise RAG Pipeline: Orchestrated by LangChain for precise document chunking, citation, and hallucination reduction.
  • 🔑 Bring Your Own Key (BYOK): A secure, user-centric architecture that requires users to provide their own Gemini API key (AES-encrypted in the database) to use the app, ensuring zero LLM costs for the host.
  • 🛡️ Production-Ready Guardrails: Hardened with Upstash Redis rate-limiting (req/min & req/day) and Supabase row-level security quotas (max notebooks/files) to protect the backend from abuse.
  • 🔍 Deep Semantic Search: Utilizes Supabase pgvector to find hidden connections across massive PDF uploads and web pages.
  • 📊 Live Analytics Dashboard: A highly responsive, collapsible React interface featuring real-time state synchronization via custom dispatch events. Fully optimized for both Desktop and Mobile.

📸 Interface Preview

Intelligent Analytics Dashboard (Responsive)

Desktop Dashboard

Desktop View (Collapsible Sidebar)
Mobile Dashboard

Mobile View

Context-Aware AI Chat

Desktop Chat

Immersive Reading Mode
Mobile Chat

Mobile Chat Interface

Data Ingestion & Controls

Document Upload

Context Upload
Upload Mobile

Mobile View
User Settings

User Preferences
Settings Mobile

Mobile Config

🚀 Getting Started

1. Backend Setup

cd backend
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -r requirements.txt

2. Frontend Setup

cd ../frontend
npm install

3. Environment Variables

Create .env files in both backend and frontend directories following the .env.example templates.

4. Run the Application

Terminal 1 — Backend

cd backend
python -m uvicorn main:app --reload

Terminal 2 — Frontend

cd frontend
npm run dev


Built with ❤️ by Kalash Pratap Gaur

GitHubRepository

About

A professional-grade RAG platform for financial document analysis and portfolio insights. Built with Gemini 2.5, LangGraph, and Supabase.

Topics

Resources

License

Stars

Watchers

Forks