Code Compass

Code Compass – AI-Powered Open-Source Contribution Helper Code Compass makes open-source contribution easier by helping developers understand complex codebases, visualize dependencies, and find actionable contribution opportunities. Core Problem New developers struggle with large, unfamiliar repositories and lack clear starting points. Code Compass bridges this gap with AI-driven insights and interactive visualization. Key Features ✅ AI-Powered Analysis – GPT-5-based repository summarization, code explanations, and intelligent Q&A. ✅ Visual Knowledge Graphs – Interactive dependency maps using NetworkX + PyVis for files, classes, and functions. ✅ Smart Contribution Guidance – Detects TODOs, missing tests, and suggests beginner-friendly GitHub issues. ✅ Multi-Language Support – Handles Python, JavaScript, TypeScript, HTML, CSS, and config files. How It Works Repo Ingestion – Clone any GitHub repo via API. Graph Mapping – Build a knowledge graph of imports, function calls, and file relationships. AI Insight Layer – GPT-5 answers natural language questions, explains architecture, and recommends contributions. Interactive Exploration – Filter graphs, view file summaries, and discover improvement areas. Tech Stack Frontend: Streamlit, PyVis Backend: FastAPI, Python AI & NLP: GPT-5 (via AIML), Google Generative AI embeddings, FAISS for semantic search Visualization: NetworkX, Plotly Integration: GitHub API (PyGithub) Why It’s Innovative Unlike basic code search tools, Code Compass combines graph visualization, AI-driven explanations, and predictive contribution detection. It not only answers “what” and “where” but also explains “why” and “how”, empowering newcomers to contribute confidently. One-Line Summary: Code Compass transforms codebases into interactive, explainable maps, making open-source projects accessible to everyone.