|
| 1 | +--- |
| 2 | +title: "GSoC ’25 Week 02 Update by Om Santosh Suneri" |
| 3 | +excerpt: "To Develop a Basic RAG Debugger for Music Blocks" |
| 4 | +category: "DEVELOPER NEWS" |
| 5 | +date: "2025-06-14" |
| 6 | +slug: "2025-06-14-gsoc-25-omsuneri-week02" |
| 7 | +author: "Om Santosh Suneri" |
| 8 | +description: "GSoC'25 Contributor working on AI-powered Debugger for Music Blocks" |
| 9 | +tags: "gsoc25,sugarlabs,week02,Debugger,AI,Music Blocks" |
| 10 | +image: "assets/Images/GSOC.png" |
| 11 | +--- |
| 12 | + |
| 13 | +<!-- markdownlint-disable --> |
| 14 | + |
| 15 | +# Week 02 Progress Report by Om Santosh Suneri |
| 16 | + |
| 17 | +**Project:** [AI-powered Debugger for Music Blocks](https://github.com/omsuneri/AI-powered-Debugger-for-Music-Blocks) |
| 18 | +**Mentors:** [Walter Bender](https://github.com/walterbender/) [Sumit Srivastava](https://github.com/sum2it) |
| 19 | +**Assisting Mentors:** [Devin Ulibarri](https://github.com/pikurasa/) |
| 20 | +**Reporting Period:** 2025-06-08 - 2025-06-14 |
| 21 | + |
| 22 | +--- |
| 23 | + |
| 24 | +## Goals for This Week |
| 25 | + |
| 26 | +- **Goal 1:** Enhance and Polish the Converter code |
| 27 | +- **Goal 2:** To Make the JSON to Text Converter Publicly Accessible |
| 28 | +- **Goal 3:** To Develop a Basic RAG Debugger for Music Blocks |
| 29 | + |
| 30 | +--- |
| 31 | + |
| 32 | +## This Week’s Achievements |
| 33 | + |
| 34 | +1. **Enhance and Polish the Converter code** |
| 35 | + - I refined the output of the JSON to Text Converter by improving how blocks, parameters, and nested structures are represented. I also optimized the formatting and added clearer visual symbols to make the structure easier to follow. |
| 36 | + - A well-structured and readable output is critical for debugging and learning. These enhancements make the converter not only functional but truly useful, especially for beginners who may be overwhelmed by raw JSON. The clarity improvements bridge the gap between raw code and conceptual understanding. |
| 37 | + - GitHub Repository: [JSON to Text representation](https://github.com/omsuneri/JSON-to-Text-representation) |
| 38 | + |
| 39 | +2. **To Make the JSON to Text Converter Publicly Accessible** |
| 40 | + - I deployed the Music Blocks JSON to Text Converter as a static web tool using GitHub Pages. This involved setting up the project structure for deployment, ensuring browser compatibility, and verifying that the tool works seamlessly for any user without needing local installation. |
| 41 | + - By making the converter publicly accessible, I’ve removed a major barrier for non-technical users who want to understand or debug Music Blocks projects. Now, anyone can paste their JSON and instantly see a human-readable text format, making it easier to interpret the project logic, especially for educators and learners. |
| 42 | + - JSON to Text Converter: [Live Demo](https://omsuneri.github.io/JSON-to-Text-representation/) |
| 43 | + |
| 44 | +3. **To Develop a Basic RAG Debugger for Music Blocks** |
| 45 | + - I created the initial version of a Retrieval-Augmented Generation (RAG) app that acts as a debugger for Music Blocks. It uses Google Gemini (free API) for natural language responses and Qdrant as a vector database to search over relevant Music Blocks documentation and sample project data. |
| 46 | + - This is the first step toward an AI-powered assistant that can help users understand errors, debug project files, and learn concepts interactively. It lays the groundwork for a smarter, more accessible debugging experience tailored specifically to the Music Blocks environment. |
| 47 | + - GitHub Repository: [AI-powered Debugger for Music Blocks](https://github.com/omsuneri/AI-powered-Debugger-for-Music-Blocks) |
| 48 | + |
| 49 | +--- |
| 50 | + |
| 51 | + |
| 52 | +## Challenges & How I Overcame Them |
| 53 | + |
| 54 | +- **Challenge:** Error 99 – Deployment Failure due to Network Binding |
| 55 | + **Solution:** I updated the Gemini API implementation to avoid explicitly binding to a local address and ensured it followed the correct networking model for serverless deployment. I also verified that no hardcoded host values (like 127.0.0.1) were used and that the requests use standard internet routes. |
| 56 | + |
| 57 | +- **Challenge:** Reducing Container Size from 7.1 GB to Under 4 GB |
| 58 | + **Solution:** I explored two approaches: |
| 59 | + - Optimization: I removed redundant or unused files from the embedding directory and ensured the vector database stored only the most relevant documents. |
| 60 | + - Cloud-based Embeddings: I evaluated storing the embeddings externally (e.g., by using a hosted Qdrant instance or remote storage) so that the app could load them at runtime, rather than bundling them in the container.These optimizations brought the container size within limits and made the app deployable on Railway. |
| 61 | + |
| 62 | +--- |
| 63 | + |
| 64 | +## Key Learnings |
| 65 | + |
| 66 | +- Deployment environments have strict constraints that require optimization and flexibility |
| 67 | +I learned that successful deployment isn’t just about writing functional code — it's equally about managing resources (like container size) and handling platform-specific limitations, such as networking and storage. |
| 68 | +- Early-stage AI apps benefit greatly from clear modularity and cloud-ready design |
| 69 | +While building the RAG debugger, I realized the importance of designing components (like embeddings, API logic, and vector search) to be loosely coupled and scalable, which helps avoid technical roadblocks during cloud deployment. |
| 70 | + |
| 71 | +--- |
| 72 | + |
| 73 | +## Next Week’s Roadmap |
| 74 | + |
| 75 | +- Deploy the AI-Powered Debugger App to a Cloud Hosting Platform. |
| 76 | +- Create Embeddings from Music Blocks Project Text Representations. |
| 77 | +- Improve LLM Response Language for Kids and Junior Learners. |
| 78 | + |
| 79 | +--- |
| 80 | + |
| 81 | +## Resources & References |
| 82 | + |
| 83 | +- **Repository:** [JSON to Text representation](https://github.com/omsuneri/JSON-to-Text-representation) |
| 84 | +- **Repository:** [AI-powered Debugger for Music Blocks](https://github.com/omsuneri/AI-powered-Debugger-for-Music-Blocks) |
| 85 | + |
| 86 | +--- |
| 87 | + |
| 88 | +## Acknowledgments |
| 89 | + |
| 90 | +Thank you to my mentors, the Sugar Labs community, and fellow GSoC contributors for ongoing support. |
| 91 | + |
| 92 | +--- |
| 93 | + |
| 94 | +## Connect with Me |
| 95 | + |
| 96 | +- GitHub: [@omsuneri](https://github.com/omsuneri) |
| 97 | + |
| 98 | +- LinkedIn: [Om Santosh Suneri](https://www.linkedin.com/in/om-santosh-suneri-736767166/) |
| 99 | +- Twitter: [@suneri_om](https://x.com/suneri_om) |
| 100 | + |
| 101 | +--- |
0 commit comments