How 05786k/moodify_applied-ai-system works
Moodify takes a listener’s taste profile through semantic retrieval, weighted ranking, and a grounded explanation, then presents recommendations in a Streamlit UI or CLI. The glossary extends retrieval for unfamiliar genre and mood terms; retrieval failures fall back to scoring the full catalog, and explanation failures use a rule-based summary. The sampled sources show the shared pipeline and front-end calls; unsampled code is represented only where the README documents its capability.
Main entry points: app.py Streamlit UI · retriever.py Semantic retrieval · main.py CLI · explainer.py Explanation generator
Components 11
User interfaces
- Streamlit UI
app.py - CLI
src/main.py
Recommendation pipeline
- Shared pipeline
src/pipeline.py - Semantic retrieval
src/retriever.py - Song embeddings
src/retriever.py - Weighted scorer
src/recommender.py
Music knowledge
- Song catalog
data/songs.csv - Genre/mood glossary
src/glossary.py
Explanation generation
- Explanation generator
src/explainer.py
Other components
- Listener
- Anthropic Claude
Connections 19
- Listener → Streamlit UI: enters preferences
README.md - Listener → CLI: selects profile
README.md - Streamlit UI → Shared pipeline: requests recommendations
app.py - CLI → Shared pipeline: requests recommendations
src/main.py - Streamlit UI → Song catalog: loads songs
app.py - CLI → Song catalog: loads songs
src/main.py - Streamlit UI → Song embeddings: embeds songs
app.py - CLI → Song embeddings: embeds songs
src/main.py - Streamlit UI → Semantic retrieval: shows retrieval details
app.py - Streamlit UI → Weighted scorer: computes baseline
app.py - Shared pipeline → Semantic retrieval: retrieves and ranks
src/pipeline.py - Shared pipeline → Explanation generator: explains results
src/pipeline.py - Semantic retrieval → Song embeddings: compares vectors
src/retriever.py - Semantic retrieval → Genre/mood glossary: enriches query
src/retriever.py - Semantic retrieval → Weighted scorer: scores shortlist
src/retriever.py - Semantic retrieval → Song catalog: retrieves candidates
README.md - Explanation generator → Anthropic Claude: generates explanation
src/explainer.py - Explanation generator → Streamlit UI: returns explanation
app.py - Explanation generator → CLI: returns explanation
src/main.py