Skip to content

Code Compass

Code Compass augments human learning and contribution by converting opaque codebases into interactive, explainable knowledge graphs—paired with NLP and ML agents that surface high-impact, learnable contribution opportunities.

Core trick

Parses a repository into an interactive dependency graph, then uses embedding-based RAG to answer questions about the code.

Tags

Description

$29
OSAMAGHAFFARTKOJL/GPT_5-Hackathon★ 01 forksPythonCreated Aug 19, 2025 · last push Aug 24, 2025

README excerpt

# 🔗 Code Compass

Open-Source Contribution Helper - Understand, visualize, and contribute to GitHub repositories easily.

## 🚀 Features

- **Smart Repository Analysis**: Automatically analyze code structure and dependencies
- **Interactive Visualization**: Explore file relationships with an interactive graph
- **AI-Powered Q&A**: Ask questions about the code and get intelligent answers
- **Contribution Guidance**: Get personalized suggestions for how to contribute
- **Error Solving**: Ask about errors and get step-by-step solutions with code examples
- **Real-time Filters**: Adjust visualization filters without re-analyzing

## 📋 Requirements

- Python 3.8+
- AIML API Key (for GPT-5 powered analysis)
- Google API Key (for embeddings and RAG)
- GitHub Token (optional, for higher rate limits)
-
- #Check the dmeo here: https://gpt5-hackathon.streamlit.app/


![Untitled diagram _ Mermaid Chart-2025-08-23-062842](https://github.com/user-attachments/assets/09e8d3c4-c095-49e5-9dd8-5513bc41bed5)

## 🛠 Installation

1. Clone the repository:
```bash
git https://github.com/OSAMAGHAFFARTKOJL/GPT_5-Hackathon
cd code-compass
```

2. Install dependencies:
```bash
pip install -r requirements.txt
```

3. Run the application:
```bash
streamlit run app.py
```

## 📁 Project Structure

```
code-compass/
├── app.py                          # Main Streamlit application
├── requirements.txt                # Python dependencies
├── README.md                       # Project documentation
├── component

Team