Skip to content

Repository files navigation

Physical AI & Humanoid Robotics Textbook

Interactive textbook on embodied intelligence and robotic systems, built with Docusaurus. Includes a built-in AI chatbot that answers questions using textbook content.

Features

  • Dark Futuristic Theme: Custom robotics-themed design with glass-morphism, animations
  • 4 Modules + Capstone: ROS 2, Gazebo/Unity, NVIDIA Isaac, VLA Models
  • AI Chatbot: Floating widget answers questions via Groq (Llama 3) + TF-IDF retrieval over textbook content
  • Streaming Responses: Real-time token-by-token display with source citations and follow-up suggestions
  • Responsive: Works on all device sizes

Tech Stack

Layer Tech
Frontend Docusaurus v3, React 19, TypeScript, CSS Modules
Chat API Node.js serverless functions (Vercel)
Retrieval TF-IDF (pre-built index from markdown)
LLM Groq (Llama 3.3-70B)

Getting Started

# Install
npm install

# Set your Groq API key
cp .env.example .env
# Edit .env with your GROQ_API_KEY

# Start dev server
npm start

For API testing, deploy to Vercel (the prebuild hook auto-generates the search index).

Project Structure

Physical-AI-Book-RAG/
├── api/                     # Vercel serverless functions
│   ├── chat.js             # POST /api/chat — streaming Q&A
│   └── search.js           # POST /api/search — text search
├── docs/                    # Textbook content (markdown)
│   ├── module1/            # ROS 2
│   ├── module2/            # Gazebo & Unity
│   ├── module3/            # NVIDIA Isaac
│   ├── module4/            # VLA Models
│   └── capstone/           # Capstone project
├── scripts/
│   └── build-index.js      # Prebuild: generates TF-IDF index
├── src/
│   ├── components/
│   │   ├── ChatWidget/     # Floating AI chatbot widget
│   │   └── HomepageFeatures/  # Module showcase cards
│   ├── css/custom.css      # Global dark futuristic theme
│   ├── pages/              # Homepage
│   └── theme/Root.tsx      # Global widget injection
├── specs/                   # Feature specifications
├── static/img/              # Images and icons
├── docusaurus.config.ts
├── sidebars.ts
└── vercel.json

Deployment

Deploy to Vercel — connect your repo, set GROQ_API_KEY in environment variables. The prebuild hook generates the search index automatically during build.

About

RAG system for Physical AI textbooks. Ask questions about AI concepts using retrieval-augmented generation with PDF content

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages