app.py

import os
import requests
import gradio as gr
from groq import Groq

def generate_docs(repo_id: str) -> str:
    """
    Fetches repository details from GitHub and generates documentation using the Groq API.
    """
    # Fetch basic repo info from GitHub
    if repo_id.endswith(".git"):
        repo_id = repo_id[:-4]
    prefix = "github.com/"
    start = repo_id.find(prefix)
    if start != -1:
        # Offset start by length of prefix
        repo_path = repo_id[start + len(prefix):]
        print(repo_path)
    else:
        print("Invalid URL format")
    response = requests.get(repo_path)
    if response.status_code != 200:
        return f"Error: Unable to fetch repository details for '{repo_id}'. Please check the repository ID."
    url = f"https://api.github.com/repos/{repo_path}"
    repo_data = response.json()
    repo_description = repo_data.get("description", "No description provided.")
    readme = repo_data.get("README.md", "No description provided.")
  
    repo_name = repo_data.get("name", repo_id)

    # Construct a prompt that includes some of the repository details.
    prompt = (
        f"Generate comprehensive documentation for the GitHub repository '{repo_id}'. "
        f"The repository is named '{repo_name}' and its description is: {repo_description}, you should use {readme} for the base docs.\n\n"
        "Please include sections such as an introduction, installation instructions, usage examples, "
        "and any relevant details that would help a new user understand and work with this repository."
    )

    # Retrieve the Groq API key from environment variables.
    groq_api_key = os.environ.get("GROQ_API_KEY")
    if not groq_api_key:
        return "Error: GROQ_API_KEY environment variable is not set."

    # Initialize the Groq client.
    client = Groq(api_key=groq_api_key)

    try:
        # Call the Groq API with the generated prompt.
        chat_completion = client.chat.completions.create(
            messages=[
                {"role": "user", "content": prompt}
            ],
            model="llama-3.3-70b-versatile",
            stream=False,
        )
    except Exception as e:
        return f"Error calling Groq API: {e}"

    # Extract and return the generated documentation.
    documentation = chat_completion.choices[0].message.content
    return documentation

# Define the Gradio Blocks interface.
with gr.Blocks() as demo:
    gr.Markdown("# GitHub Repository Documentation Generator")
    gr.Markdown(
        "Enter a GitHub repository ID (in the format `user/repo`) below. "
        "This tool fetches repository details and uses the Groq API to generate documentation."
    )
    
    repo_id_input = gr.Textbox(label="GitHub Repository ID (e.g., user/repo)", placeholder="octocat/Hello-World")
    output_box = gr.Textbox(label="Generated Documentation", lines=20)
    generate_button = gr.Button("Generate Documentation")

    # When the button is clicked, call the generate_docs function.
    generate_button.click(fn=generate_docs, inputs=repo_id_input, outputs=output_box)

# Launch the Gradio app.
demo.launch()