How kain-90/rag-play works
RAG Playground is an interactive teaching and debugging app, not a single persisted RAG service: users explore text splitting, embeddings, semantic search, and context generation in separate experiment tabs. The visible embedding runtime sends tasks to a Web Worker, stores vectors, and visualizes them; the chat API resolves a configured LLM provider. The README documents broader retrieval and generation capabilities, but their detailed wiring is not shown in the sampled source, so those links are omitted or marked unverified.
Main entry points: experiment-content.tsx Experiment Tabs · embedding-tab.tsx Embedding Tab · page.tsx Experiment Page · useEmbeddingWorker.ts Worker Hook
Components 23
App Experience
- Experiment Page
src/app/experiment/page.tsx - Experiment Tabs
src/app/experiment/components/experiment-content.tsx - Header
src/app/components/header.tsx - Footer
src/app/components/footer.tsx
Text Splitting
- Splitting Tab
src/app/experiment/components/text-splitting-tab.tsx - Chunk Controls
src/app/experiment/components/text-splitting - Separator Manager
src/app/experiment/components/separator-manager.tsx - Splitting State
src/app/stores/experiment/text-splitting-store.ts - Split Logic
src/app/utils/split-text.ts
Embeddings & Retrieval
- Embedding Tab
src/app/experiment/components/embedding-tab.tsx - Embedding Controls
src/app/experiment/components/embedding - Worker Hook
src/app/hooks/useEmbeddingWorker.ts - Embedding Worker
src/app/experiment/workers/embedding.ts - Embedding State
src/app/stores/experiment/embedding-store.ts - Semantic Search
src/app/experiment/components/semantic-search-tab.tsx - Vector Visualization
src/app/experiment/components/low-vector-visualization.tsx - UMAP Projection
src/lib/utils.ts
Generation
- Generation Tab
src/app/experiment/components/generation-tab.tsx - Message Display
src/app/experiment/components/message-display.tsx - Chat API
src/app/api/chat/route.ts - LLM Resolver
src/lib/llm.ts
Other components
- Developer
- LLM Provider
Connections 25
- Developer → Experiment Page: opens
- Experiment Page → Experiment Tabs: renders
src/app/experiment/page.tsx - Experiment Page → Header: renders
src/app/experiment/page.tsx - Experiment Page → Footer: renders
src/app/experiment/page.tsx - Experiment Tabs → Splitting Tab: renders
src/app/experiment/components/experiment-content.tsx - Experiment Tabs → Embedding Tab: renders
src/app/experiment/components/experiment-content.tsx - Experiment Tabs → Semantic Search: renders
src/app/experiment/components/experiment-content.tsx - Experiment Tabs → Generation Tab: renders
src/app/experiment/components/experiment-content.tsx - Splitting Tab → Chunk Controls: uses controls
- Splitting Tab → Splitting State: uses state
- Splitting State → Split Logic: supplies split input
- Embedding Tab → Embedding Controls: renders
src/app/experiment/components/embedding-tab.tsx - Embedding Tab → Embedding State: reads state
src/app/experiment/components/embedding-tab.tsx - Embedding Tab → Splitting State: reads chunks
src/app/experiment/components/embedding-tab.tsx - Embedding Tab → Vector Visualization: renders
src/app/experiment/components/embedding-tab.tsx - Vector Visualization → UMAP Projection: projects vectors
src/app/experiment/components/low-vector-visualization.tsx - Experiment Tabs → Worker Hook: initializes
src/app/experiment/components/experiment-content.tsx - Worker Hook → Embedding Worker: posts tasks
src/app/hooks/useEmbeddingWorker.ts - Embedding Worker → Worker Hook: sends progress
src/app/hooks/useEmbeddingWorker.ts - Worker Hook → Embedding State: updates vectors
src/app/hooks/useEmbeddingWorker.ts - Semantic Search → Embedding State: uses vectors
- Generation Tab → Message Display: displays messages
- Generation Tab → Chat API: requests response
- Chat API → LLM Resolver: resolves model
src/app/api/chat/route.ts - LLM Resolver → LLM Provider: configures model
src/lib/llm.ts