Offline Knowledge Center & Socratic AI Tutor

Welcome to the Offline Knowledge Center & Socratic AI Tutor. This project is a comprehensive solution for offline learning with an integrated Socratic AI tutor.

Architecture Diagram

graph TD
    A[Scraper] -->|Outputs| B(Static Data)
    B -->|Consumed by| C[PWA React Reader]
    C <-->|Interacts with| D[FastAPI Backend]
    D <-->|RAG Pipeline| E[Gemini 2.5 Flash + Keenable RAG]

Loading

Feature Highlights

• 100% Offline-First PWA tutorial reader
• Decoupled content scraper and markdown exporter
• Socratic AI Tutor powered by Gemini 2.5 Flash
• Real-time Web Search Fallback via Keenable CLI

Setup & Running Instructions

Environment Variables

Set up the required environment variables:

export GEMINI_API_KEY="your_gemini_api_key"
export KEENABLE_API_KEY="your_keenable_api_key"

Running the Scraper & Exporter

Execute the pipeline script to scrape content and export markdown:

./run_pipeline.sh

Launching the Offline Reader

Start the React PWA offline reader:

cd offline-knowledge-center && npm run dev

Starting the AI Backend

Run the FastAPI backend for the Socratic AI Tutor:

cd OfflineTutor && uvicorn api:app --reload