How pman369/neuralpeace-ai works
NeuralPeace AI is a neuroscience learning and chat application. Users can explore structured learning modules, sign in, and ask expertise-adapted questions; the chat persists sessions and messages, streams AI responses with citations, and can surface brain-atlas context. Authenticated users can also participate in debates, with a separate fact-check function. The README documents ethical guardrails, Semantic Scholar citations, vector search, and the interactive atlas; several of those implementations were not sampled, so their internal wiring is shown only where documented or left unverified.
Main entry points: App.tsx App routing · ChatPage.tsx Chat page · useDebateRoom.ts Debate state · ai.service.ts AI client
Components 23
Application
- App routing
frontend/src/App.tsx - Auth context
frontend/src/lib/AuthContext.tsx - Onboarding
frontend/src/pages/OnboardingPage.tsx
Learning and Atlas
- Module library
frontend/src/pages/ModuleLibrary.tsx - Module detail
frontend/src/pages/ModuleDetail.tsx - Brain atlas
frontend/src/components/BrainAtlas.tsx
Chat and Debate
- Chat page
frontend/src/pages/ChatPage.tsx - Chat interface
frontend/src/components/ChatInput.tsx - Citation panel
frontend/src/components/CitationPanel.tsx - Debate lobby
frontend/src/pages/DebateLobby.tsx - Debate room
frontend/src/pages/DebateRoom.tsx - Debate state
frontend/src/hooks/useDebateRoom.ts
AI and Data Services
- Module progress
frontend/src/lib/database.ts - Chat persistence
frontend/src/lib/repositories/chat.repository.ts - AI client
frontend/src/lib/services/ai.service.ts - Chat function
supabase/functions/chat/index.ts - Hybrid retrieval
supabase/functions/chat/rag.ts - Fact check
supabase/functions/fact-check/index.ts - Knowledge embedding
supabase/functions/embed-knowledge/index.ts
Other components
- Learner
- Gemini AI
- Semantic Scholar
- Supabase
Connections 24
- Learner → App routing: opens
- App routing → Auth context: provides auth
frontend/src/App.tsx - App routing → Onboarding: routes to
frontend/src/App.tsx - App routing → Module library: routes to
frontend/src/App.tsx - App routing → Module detail: routes to
frontend/src/App.tsx - Module library → Module progress: loads progress
frontend/src/lib/database.ts - Module detail → Supabase: reads module
frontend/src/pages/ModuleDetail.tsx - App routing → Chat page: routes to
frontend/src/App.tsx - Chat page → Chat interface: renders
frontend/src/pages/ChatPage.tsx - Chat page → Chat persistence: loads and saves
frontend/src/pages/ChatPage.tsx - Chat page → AI client: requests response
- AI client → Chat function: invokes
frontend/src/lib/services/ai.service.ts - Chat function → Hybrid retrieval: retrieves context
- Hybrid retrieval → Supabase: queries knowledge
supabase/functions/chat/rag.ts - Chat function → Gemini AI: generates response
- AI client → Semantic Scholar: fetches paper details
frontend/src/lib/services/ai.service.ts - Chat page → Brain atlas: shows atlas context
frontend/src/pages/ChatPage.tsx - Chat page → Citation panel: opens citations
frontend/src/pages/ChatPage.tsx - App routing → Debate lobby: routes to
frontend/src/App.tsx - App routing → Debate room: routes to
frontend/src/App.tsx - Debate room → Debate state: uses debate state
frontend/src/pages/DebateRoom.tsx - Debate state → Supabase: reads and writes
frontend/src/hooks/useDebateRoom.ts - Debate state → Fact check: invokes
frontend/src/hooks/useDebateRoom.ts - Knowledge embedding → Supabase: embeds knowledge