INSPIRATION
Harmonic Link was born from a fascination with the connections that perpetually drive the creative community and the deeply interconnected nature of music. I was inspired by the simple yet profound idea that no artist exists in a vacuum; every great collaboration and artistic relationship fuels creativity, leading to an almost circular inspiration across genres and generations. The initial goal was to illuminate how these tiny, often hidden links build up a massive, beautiful global music community, highlighting the fact that music is a collaborative and deeply relational art form.
PROJECT STACK AND ARCHITECTURE
Harmonic Link is a full-stack application relying on a robust Node.js backend to connect computational analysis with creative content generation.
Backend The core of the system uses Node.js with Express.js for routing API requests.
Harmonic Path Logic : To map the "harmonic path," the backend utilizes a dedicated PostgreSQL database (configured for MusicBrainz data). This data is queried using a Bidirectional Breadth-First Search (BFS) algorithm to find the shortest, most efficient collaborative route between two artists.
External APIs:
- Spotify, Genius APIs: Used for artist search functionality and fetching presentation data, such as artist images, to enrich the path visualization.
- Google Generative AI (Gemini 2.5 Pro): Used creatively to generate a custom, 10-12 song playlist based on the calculated path, curating tracks that capture the essence of the musical journey, as well as supplementary support for genre/contextual connections.
Frontend Uses a component-based structure built with React to handle user interaction and dynamically display search results, the calculated paths, and the generated playlists.
Development and Learned Lessons
Building Harmonic Link was an intensive learning experience, particularly concerning the intricacies of integrating various external data sources. The primary challenge faced during development was API integration, particularly with Spotify. Issues included managing the Spotify Client Credentials flow for authentication and ensuring the token refresh mechanism was robust enough to handle continuous requests. This required getting down and dirty with secure authorization practices and continuous token monitoring. Another signifiant challenge was certainly working alone and having to tackle a large workload with little time or manpower.
Lessons Learned
- Database Query Optimization: Mastering the Bi-directional BFS and creating highly performant PostgreSQL queries (getConnectedArtists, getArtistIdByName) was essential for delivering fast pathfinding results on a large dataset like MusicBrainz.
- Generative AI Integration: Learning how to effectively engineer prompts for the Gemini model to return reliable, structured JSON output for the playlist feature was a key technical skill acquired.
Conclusion: The Value of the Link
Harmonic Link succeeded in creating a tangible representation of musical interconnectedness. By demonstrating that the path between any two artists is often much shorter than imagined, it validated and even surpassed my belief that artistic relationships form a tightly woven, vibrant, and endless source of inspiration and collaboration. This project is a testament to the powerful synergy between structured graph algorithms and creative generative AI, all united by a passion for the music community.
Limitations
- Loading screen plays locally but failed upon deployment, do not fear the black screen it is just thinking (:
- Must enter artist names twice to find path, was short on time to fine tune UI
- Some search functionalities were simplified for submission to reduce result wait time
Log in or sign up for Devpost to join the conversation.