CodeGraph AI — Smart Code Passport

Inspiration

As someone with a background in Information Technology, IT operations, and cybersecurity, I have always been interested in how artificial intelligence can simplify complex technical challenges.

One of the biggest challenges developers face is understanding unfamiliar codebases, identifying important files, and recognizing how different components interact. Traditional code exploration can be time-consuming, especially when working with large or unfamiliar projects.

This inspired me to build CodeGraph AI — Smart Code Passport, a Python-based tool that analyzes source-code relationships and uses artificial intelligence to transform technical information into understandable, actionable insights.

My goal was to explore how AI could make software analysis more accessible, efficient, and intelligent.

What It Does

CodeGraph AI analyzes a software repository and helps developers understand its architecture through structured code analysis.

Its capabilities include:

  • Repository Analysis: Indexes Python project files and examines relationships between components.
  • Dependency Insights: Highlights important modules and their connections.
  • Graph-Based Intelligence: Uses code relationships to support more relevant analysis.
  • AI-Powered Reports: Generates readable Smart Code Passport reports using Google Gemini.
  • Premium Access Prototype: Demonstrates how PayPal Sandbox payment verification can unlock AI-generated reports.

The project combines software engineering, artificial intelligence, and payment technology in a single experimental workflow.

How I Built It

I developed CodeGraph AI using Python, GitHub, Google Colab, Google Gemini, and the PayPal Sandbox REST API.

I started by building the core code-analysis engine, organizing the project into modules responsible for indexing, graph relationships, evaluation, and AI-assisted explanations.

I then implemented automated tests to validate the project’s functionality and used Google Colab to execute the code and evaluate its behavior.

Next, I integrated Google’s Gemini AI model to generate natural-language reports from the repository analysis results.

To explore monetization, I developed a PayPal Sandbox integration that authenticates through PayPal’s REST API, verifies a completed test payment, and unlocks premium AI report generation.

The complete workflow was successfully demonstrated in Google Colab using a completed $1 USD Sandbox transaction. The payment and AI integrations remain prototype features rather than a production-ready checkout system.

Challenges I Faced

One of my biggest challenges was connecting multiple technologies while ensuring that each component worked correctly.

During development, I encountered several technical difficulties:

  • Python Environment Issues: Resolving missing modules, incorrect file paths, and runtime resets in Google Colab.
  • AI Model Availability: Troubleshooting unavailable or overloaded Gemini models before successfully generating reports.
  • PayPal API Integration: Learning OAuth authentication, Sandbox payment processing, order capture, and payment-status verification.
  • Credential Security: Managing API keys and PayPal credentials through Google Colab Secrets instead of exposing them in source code.
  • Integration Testing: Connecting repository analysis, payment verification, and AI-generated reporting into one workflow.

Each challenge required debugging, experimentation, and learning new technical concepts.

Accomplishments That I’m Proud Of

My proudest achievement is successfully building and testing a working AI-assisted code-analysis prototype while learning new development technologies throughout the process.

I successfully:

  • Developed a modular Python code-analysis project.
  • Executed automated tests to validate the core functionality.
  • Connected Google Gemini to generate Smart Code Passport reports.
  • Authenticated with PayPal Sandbox and verified a completed test payment.
  • Demonstrated a payment-gated AI reporting workflow in Google Colab.
  • Published the project source code on GitHub.

The project represents an important step in my journey from IT operations and cybersecurity toward AI development and intelligent automation.

What I Learned

This project significantly expanded my understanding of practical software development.

I gained hands-on experience with Python project architecture, GitHub workflows, REST API integration, OAuth authentication, AI model integration, automated testing, and debugging.

I also learned how important it is to design secure, reproducible workflows when connecting payment systems with AI-powered services.

Most importantly, I discovered how existing IT and cybersecurity knowledge can be applied to building innovative AI solutions.

What’s Next

My next goal is to transform CodeGraph AI into a more complete developer platform.

Future improvements include:

  • Building an interactive web dashboard.
  • Supporting larger repositories and additional programming languages.
  • Improving dependency visualization and architectural insights.
  • Adding automated code-quality and security checks.
  • Implementing a production-ready PayPal checkout and entitlement system.
  • Supporting downloadable reports and team collaboration.
  • Expanding AI-powered recommendations for developers.

CodeGraph AI — Smart Code Passport is more than a hackathon experiment. It is the foundation of my journey toward building practical, accessible AI-powered developer tools.

⸻

GitHub Repository: https://github.com/fhalhashimi1-creator/Fatima

Project Demo: https://colab.research.google.com/drive/1ZgwOIipSgmGW9Ziyo0QCt6Y4hpiySQ7Q?usp=sharing

Video Demonstration: https://youtu.be/Zumn_2Dl97o

Built With

  • ai
  • api-integration
  • artificial-intelligence
  • automation
  • code-analysis
  • dependency-graphs
  • developer-tools
  • gemini-api
  • generative-ai
  • git
  • github
  • google-colab
  • google-gemini
  • graph-analysis
  • json
  • large-language-models
  • markdown
  • oauth-2.0
  • paypal
  • paypal-sandbox
  • python
  • python-unittest
  • rest-api
  • software-engineering
  • static-analysis
Share this project:

Updates

Submission history