GITHUB.md

GitHub OAuth Setup Guide

To enable the "Connected Apps" GitHub integration where users can log in and directly import their public and private repositories, you need to create a GitHub OAuth Application.

Step 1: Create the OAuth Application

1. Go to your GitHub Settings: Developer Settings -> OAuth Apps.
2. Click New OAuth App.
3. Fill in the details:
   • Application name: devportal2 (or anything you prefer)
   • Homepage URL: The base URL of your Hugging Face Space (e.g., https://ajitdoval-devportal2.hf.space)
   • Authorization callback URL: Must be exactly your Space URL followed by /api/github/callback. (e.g., https://ajitdoval-devportal2.hf.space/api/github/callback)
4. Click Register application.

Step 2: Get your Credentials

1. On the app page you just created, you will see the Client ID. Copy this.
2. Click Generate a new client secret. Copy the generated secret immediately (it will be hidden later).

Step 3: Configure Environment Variables

Go to your Hugging Face Space settings, and add the following Variables and secrets:

• GITHUB_CLIENT_ID = (paste the Client ID from Step 2)
• GITHUB_CLIENT_SECRET = (paste the Client Secret from Step 2)

Once these are set, restart your Space. The "Connected Apps" integration will now securely link user accounts and fetch repositories!