How mkcodes4/the-swift-journal works
Taylor Swift Discography Analysis combines a lyric-and-album exploration website with a Python API for semantic search and AI-assisted chat. Users can explore sentiment and era patterns, search lyrics by meaning, or ask the chat agent a question; the backend routes chat queries to lyric or statistics tools, gathers evidence, and synthesizes a response. The graph includes documented analysis and discovery capabilities, but sampled evidence does not establish how the Next.js API routes connect to the Python service or which datasets power every page.
Main entry points: main.py Python API · coordinator.py Query coordinator · page.tsx Sentiment explorer · lyrics_agent.py Lyrics agent
Components 25
Web experience
- Discography home
app/page.tsx - Vault search page
app/search/page.tsx - Sentiment explorer
app/sentiment/page.tsx - Era trends page
app/trends/page.tsx - Chat interface
components/ChatAgent.tsx - Song exhibit modal
components/ExhibitModal.tsx - Site navigation
components/Header.tsx
API layer
- Chat API route
app/api/chat/route.ts - Sentiment API route
app/api/sentiment/route.ts - Songs API route
app/api/songs/route.ts - Vault search route
app/api/vault-search/route.ts - Python API
server/main.py
Chat agents
- Chat memory
server/core/memory.py - Query coordinator
server/agents/coordinator.py - Intent router
server/core/router.py - Response cache
server/core/cache.py - Lyrics agent
server/agents/lyrics_agent.py - Statistics agent
server/agents/stats_agent.py
Analysis and data
- Lyrics search tools
server/tools/lyrics_tools.py - Album statistics tools
server/tools/stats_tools.py - Analysis engine
fusion_analysis_engine.py - Web analysis data
data/taylor_swift_roberta_analysis_v3.json - Server analysis data
server/data/taylor_swift_roberta_analysis_v3.json
Other components
- Visitor
- Google Gemini
Connections 27
- Visitor → Discography home: opens
README.md - Visitor → Vault search page: searches
README.md - Visitor → Sentiment explorer: explores
README.md - Visitor → Era trends page: explores
README.md - Discography home → Site navigation: renders
- Chat interface → Chat API route: submits chat
components/ChatAgent.tsx - Sentiment explorer → Songs API route: fetches songs
app/sentiment/page.tsx - Vault search page → Song exhibit modal: opens exhibits
app/search/page.tsx - Sentiment explorer → Song exhibit modal: opens exhibits
app/sentiment/page.tsx - Python API → Chat memory: reads and updates
server/main.py - Python API → Lyrics search tools: searches lyrics
server/main.py - Python API → Album statistics tools: initializes tools
server/main.py - Python API → Lyrics agent: initializes agent
server/main.py - Python API → Statistics agent: initializes agent
server/main.py - Python API → Query coordinator: handles chat
server/main.py - Query coordinator → Response cache: checks and saves
server/agents/coordinator.py - Query coordinator → Intent router: routes query
server/agents/coordinator.py - Query coordinator → Lyrics agent: dispatches lyrics
server/agents/coordinator.py - Query coordinator → Statistics agent: dispatches stats
server/agents/coordinator.py - Query coordinator → Google Gemini: synthesizes answer
server/agents/coordinator.py - Lyrics agent → Lyrics search tools: searches content
server/agents/lyrics_agent.py - Statistics agent → Album statistics tools: gets album stats
server/agents/stats_agent.py - Lyrics search tools → Server analysis data: loads lyrics
- Album statistics tools → Server analysis data: loads album records
- Analysis engine → Web analysis data: produces analysis
- Vault search route → Python API: forwards search
- Chat API route → Python API: forwards chat