Cerebrix 🧠🤖

Your AI teaching assistant for YouTube courses, combining video lectures, textbooks, and Socratic tutoring in one conversational interface.

---

📖 Description

Cerebrix transforms passive video learning into an interactive educational experience. This AI-powered teaching assistant can answer questions, explain concepts, and provide Socratic guidance for any YouTube course with accompanying materials.

The current deployment focuses on Stanford's CS109 (Probability for Computer Scientists), but the architecture is course-agnostic and can be adapted to any subject.

Why Cerebrix?

• Fills the Learning Gap: Transforms one-way video lectures into interactive conversations.
• Learn By Doing: Receive guided hints on problems rather than direct answers.
• Course-Agnostic: Adaptable architecture supports any YouTube course.
• Always Available: 24/7 access to course-specific tutoring without waiting for office hours.
• Multi-Modal Understanding: Processes both text and images for comprehensive support.

---

💡 Motivation

While studying Stanford's CS109 on YouTube, I encountered a common frustration: there was no way to discuss problems or get guidance when attempting exercises. As someone passionate about understanding the mathematics behind AI, I wanted a TA or study companion to support this journey, so I built one.

This project emerged from that need, creating an intelligent assistant that any self-directed learner can use to enhance their online education experience.

---

Features

• Multi-Modal Knowledge Base: Ingests and understands content from both a PDF textbook and a full YouTube video playlist.
• Advanced RAG Pipeline: Uses a sophisticated Retrieval-Augmented Generation (RAG) pipeline with metadata filtering for precise, context-aware answers.
• Socratic Tutoring: When a user submits their work (via text or image), the agent analyzes their approach and provides guiding hints rather than direct answers.
• Conversational Memory: Remembers the context of the conversation for follow-up questions.
• Powered by LangGraph: Built on a robust, stateful agent architecture using LangGraph.

Project Architecture

• Backend: A FastAPI server running a LangGraph agent.
• Frontend: A static Nextjs chat interface.
• Vector Database: AstraDB for storing and retrieving text and metadata embeddings.
• Database: PostgreSQL for storing chat history.
• Image Hosting: Cloudinary for storing page images and video keyframes.
• LLMs: Google Gemini for reasoning, vision, and generation.
• Data Ingestion: Custom Python scripts using PyMuPDF, OpenCV, and yt-dlp to process the knowledge sources.

---

🚀 Getting Started

Follow these steps to set up and run the Maths AI Tutor on your local machine.

1. Prerequisites

• Anaconda or Miniconda installed.
• Access keys for:
  • Google AI (Gemini)
  • AstraDB
  • Cloudinary
  • LangSmith (optional, but highly recommended for debugging)

2. Environment Setup

This project uses conda to manage its complex dependencies.

# Clone the repository
git clone https://github.com/ChinmayNakwa/Cerebrix.git
cd Cerebrix

# Create and activate the conda environment
conda create --name cerebrix python=3.12
conda activate cerebrix

# Or install them one by one:
conda install -c conda-forge poppler ffmpeg opencv

# Install Python packages using pip
pip install -r requirements.txt

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

---

🙏 Acknowledgments

• Stanford CS109 course materials
• LangChain and LangGraph teams
• Google Gemini AI
• The open-source community

---

📧 Contact

For questions or feedback, please open an issue on GitHub or reach out to 29chinmaynakwa@gmail.com.

---

⚠️ Important Note: When replicating this project for other courses, be mindful of copyright and fair use policies for course materials. Ensure you have appropriate permissions to process and use the content.

⚖️ Copyright & Fair Use Notice

This project is designed as an educational tool to enhance learning from publicly available course materials. We believe this constitutes fair use under copyright law for the following reasons:

• Educational Purpose: Non-commercial teaching aid for self-directed learners
• Transformative Use: Creates an interactive tutoring interface not present in original materials
• Attribution: All content is attributed to original creators with links to source materials
• No Market Harm: Designed to complement, not replace, the original course experience

All course content remains the property of its original creators. This project:

• Does not claim ownership of any course materials
• Is not monetized in any way
• Can be removed upon request from content owners

If you are a content owner and have concerns about this project's use of your materials, please contact 29chinmaynakwa@gmail.com and we will respond promptly.

For other users replicating this project: Please ensure you have appropriate permissions for any copyrighted materials you process. Fair use determinations are made on a case-by-case basis# Cerebrix 🧠🤖

Your AI teaching assistant for YouTube courses, combining video lectures, textbooks, and Socratic tutoring in one conversational interface.

---