Skip to content

Generate professional GitHub repository introduction PPTs in under 5 minutes using Qwen 2.5-7b via Azure AI Foundry Local and the GitHub Copilot SDK.

Notifications You must be signed in to change notification settings

kinfey/GenGitHubRepoPPT

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

8 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Transform GitHub READMEs into Professional PowerPoint Presentations with Hybrid AI

story

Powered by Qwen-2.5-7B (Foundry Local) + Claude Sonnet 4.5 (GitHub Copilot SDK)

License: MIT Python 3.10+ Foundry Local GitHub Copilot SDK


๐Ÿ“– Project Overview

bg

GenGitHubRepoPPT is an innovative hybrid AI solution that combines the power of local AI models with cloud-based AI agents to automatically generate professional PowerPoint presentations from GitHub repository README files.

The Hybrid Approach

This project leverages a two-stage AI pipeline:

  1. Content Generation Stage: Uses Qwen-2.5-7B (a 7-billion parameter language model) running locally via Microsoft Foundry Local to analyze GitHub README files and generate comprehensive PPT outlines and content
  2. Presentation Creation Stage: Utilizes GitHub Copilot SDK to transform the generated outline into a fully-formatted, professional PowerPoint presentation

Key Benefits

  • โœ… Local Privacy: Sensitive repository analysis happens locally with Qwen-2.5-7B CPU inference
  • โœ… Professional Quality: GitHub Copilot SDK ensures polished, well-designed presentations
  • โœ… Fast Generation: Complete PPT creation in approximately 5 minutes
  • โœ… Multi-language Support: Supports English, Simplified Chinese, and Traditional Chinese
  • โœ… Cost-Effective: Leverages free local models with minimal cloud API usage

๐Ÿ—๏ธ Architecture Diagram

arch

Workflow Steps

  1. README Fetching: User provides GitHub repository URL โ†’ System fetches README.md content
  2. Outline Generation: README content โ†’ Foundry Local (Qwen-2.5-7B) โ†’ Structured PPT outline
  3. PPT Creation: Outline โ†’ GitHub Copilot SDK โ†’ Professional PowerPoint file
  4. Download: User receives ready-to-use PPTX presentation

๐Ÿ”ง Core Technologies

1. Microsoft Foundry Local

Foundry Local is a local AI runtime that enables running large language models on your own hardware with OpenAI-compatible APIs.

Features used in this project:

  • Local deployment of Qwen-2.5-7B model
  • CPU-based inference for accessibility
  • OpenAI-compatible chat completion API
  • No external API calls for content analysis

Why Foundry Local?

  • Privacy-first approach for repository analysis
  • No cloud dependencies for content generation
  • Free and open-source
  • Supports various quantized models for CPU inference

2. GitHub Copilot SDK

GitHub Copilot SDK provides programmatic access to GitHub Copilot's AI capabilities, enabling developers to build AI-powered applications.

Features used in this project:

  • Integration with Claude Sonnet 4.5 model
  • Custom skill system for PPT generation
  • Streaming responses for real-time feedback
  • Professional document creation capabilities

Why GitHub Copilot SDK?

  • Access to state-of-the-art models (Claude Sonnet 4.5)
  • Specialized skills for complex tasks
  • High-quality output formatting
  • Seamless integration with development workflows

๐Ÿš€ Quick Start

Prerequisites

  1. Python 3.10 or higher
  2. Microsoft Foundry Local running with Qwen-2.5-7B model
  3. GitHub Copilot SDK installed and configured
  4. Git (for cloning the repository)

Installation

# Clone the repository
git clone https://github.com/kinfey/GenGitHubRepoPPT.git
cd GenGitHubRepoPPT

# Navigate to app directory
cd app

# Install Python dependencies
pip install -r requirements.txt

# Install GitHub Copilot SDK (if not already installed)
# Follow instructions at: https://github.com/github/copilot-sdk

Configuration

Create or verify your .env file in the app directory:

FOUNDRYLOCAL_ENDPOINT=Your Foundry Service Endpoint such as http://localhost:51498/v1
FOUNDRYLOCAL_API_KEY=nokey
FOUNDRYLOCAL_MODEL_DEPLOYMENT_NAME=qwen2.5-7b-instruct-generic-cpu:4

Running the Application

# Make sure Foundry Local is running with Qwen-2.5-7B model
# Then start the Flask server
python app.py

Visit http://localhost:5001 in your browser.


๐Ÿ“‚ Project Structure

GenGitHubRepoPPT/
โ”œโ”€โ”€ README.md                      # This file
โ”œโ”€โ”€ app/
โ”‚   โ”œโ”€โ”€ app.py                    # Flask backend server
โ”‚   โ”œโ”€โ”€ requirements.txt          # Python dependencies
โ”‚   โ”œโ”€โ”€ README.md                 # App-specific documentation
โ”‚   โ”œโ”€โ”€ .env                      # Environment configuration
โ”‚   โ”œโ”€โ”€ templates/
โ”‚   โ”‚   โ””โ”€โ”€ index.html           # Main web interface
โ”‚   โ”œโ”€โ”€ static/
โ”‚   โ”‚   โ”œโ”€โ”€ css/
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ style.css        # Application styles
โ”‚   โ”‚   โ””โ”€โ”€ js/
โ”‚   โ”‚       โ”œโ”€โ”€ app.js           # Main application logic
โ”‚   โ”‚       โ””โ”€โ”€ i18n.js          # Internationalization
โ”‚   โ”œโ”€โ”€ ppt/                     # Generated PPT output directory
โ”‚   โ”œโ”€โ”€ generated_ppts/          # Alternative output directory
โ”‚   โ””โ”€โ”€ .copilot_skills/         # Copilot SDK custom skills
โ”‚       โ””โ”€โ”€ ppt/
โ”‚           โ””โ”€โ”€ SKILL.md         # PPT generation skill definition

๐ŸŽฏ Usage Guide

Step 1: Input Repository

  1. Open the web application at http://localhost:5001
  2. Enter a valid GitHub repository URL (e.g., https://github.com/microsoft/foundry-local)
  3. Click "Fetch README"

Step 2: Review Outline

  1. The system generates a structured PPT outline using Qwen-2.5-7B
  2. Review the outline content
  3. Select your preferred language (English, ็ฎ€ไฝ“ไธญๆ–‡, or ็น้ซ”ไธญๆ–‡)
  4. Click "Regenerate" if you want a different outline
  5. Click "Generate PPT" when satisfied

Step 3: Download Presentation

  1. Wait for the PPT generation (typically 3-5 minutes)
  2. Download your professional PowerPoint presentation
  3. Review and customize as needed

๐ŸŒ API Endpoints

Endpoint Method Description
/ GET Main web interface
/api/fetch-readme POST Fetch README from GitHub repository
/api/generate-outline POST Generate PPT outline using Foundry Local
/api/generate-ppt POST Create PPT file using GitHub Copilot SDK
/api/download-ppt/<session_id> GET Download generated PowerPoint file

๐Ÿ“š Related Resources

Official Documentation

AI Models

Tools & Libraries

Related Projects


๐Ÿค Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.


๐Ÿ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.


๐Ÿ™ Acknowledgments

  • Microsoft for Foundry Local framework
  • GitHub for Copilot SDK
  • Alibaba Cloud for the Qwen model family
  • Anthropic for Claude AI models

Made with โค๏ธ by kinfey

โญ Star this repo if you find it helpful!

About

Generate professional GitHub repository introduction PPTs in under 5 minutes using Qwen 2.5-7b via Azure AI Foundry Local and the GitHub Copilot SDK.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published