How yeinchingg/galaxy works
StarLearn is an astronomy-physics learning platform. The user journey spans account access, interactive astronomy content, AI-assisted learning, and recorded learning activity. Its backend serves frontend pages and APIs; RAG chat coordinates retrieval, conversation history, and generated answers, while a separate physics model supports stellar-evolution calculations. The README documents NASA daily content, 3D narration, and personalized recommendations, but sampled source does not establish all of their runtime wiring; those links are omitted or marked unverified.
Main entry points: chat_controller.py Chat and activity API · main.py FastAPI application · rag_chat_use_case.py RAG chat orchestration · database.py User and chat data
Components 21
Learning interface
- Web pages
frontend/index.html - Account UI
frontend/auth.js - 3D sky engine
frontend/sky_engine.js - H-R exploration
frontend/hr.html - News and tracking
frontend/fetch_news.js - Astronomy wiki
frontend/wiki_data.js
API and adapters
- FastAPI application
main.py - Chat and activity API
app/adapters/controllers/chat_controller.py - Authentication API
app/adapters/controllers/auth_controller.py
Learning services
- RAG chat orchestration
app/use_cases/rag_chat_use_case.py - Star simulation
app/use_cases/star_simulation_use_case.py - Stellar physics
app/domain/star_physics.py - Service contracts
app/domain/interfaces.py
Infrastructure
- User and chat data
app/infrastructure/database/database.py - Gemini AI
app/infrastructure/external_ai/gemini_service.py - Pinecone search
app/infrastructure/external_ai/pinecone_service.py - Astronomy news client
app/infrastructure/news_client.py
Other components
- Learner
- Google Gemini
- Pinecone
- News data service
Connections 24
- Learner → Web pages: uses
README.md - Web pages → FastAPI application: requests pages
main.py - Account UI → Authentication API: authenticates
- Web pages → Chat and activity API: calls APIs
README.md - Chat and activity API → RAG chat orchestration: invokes chat
app/adapters/controllers/chat_controller.py - Chat and activity API → User and chat data: reads and writes
app/adapters/controllers/chat_controller.py - Authentication API → User and chat data: reads and writes
app/adapters/controllers/auth_controller.py - RAG chat orchestration → Gemini AI: generates answers
app/use_cases/rag_chat_use_case.py - RAG chat orchestration → Pinecone search: searches context
app/use_cases/rag_chat_use_case.py - RAG chat orchestration → User and chat data: loads history
app/use_cases/rag_chat_use_case.py - FastAPI application → RAG chat orchestration: configures
main.py - FastAPI application → Gemini AI: creates service
main.py - FastAPI application → Pinecone search: creates service
main.py - FastAPI application → User and chat data: creates repository
main.py - Gemini AI → Google Gemini: calls API
app/infrastructure/external_ai/gemini_service.py - Pinecone search → Pinecone: queries index
app/infrastructure/external_ai/pinecone_service.py - Chat and activity API → News data service: fetches articles
app/adapters/controllers/chat_controller.py - News and tracking → Chat and activity API: requests news
- Learner → 3D sky engine: explores objects
README.md - Learner → H-R exploration: explores evolution
README.md - Star simulation → Stellar physics: calculates evolution
app/use_cases/star_simulation_use_case.py - 3D sky engine → Chat and activity API: requests narration
- Astronomy news client → News data service: retrieves content
- Astronomy wiki → Learner: presents references