first commit

.gitignore

@@ -0,0 +1,2 @@
+.venv
+.env

app.py

@@ -0,0 +1,140 @@
+import gradio as gr
+import os
+import requests
+import git
+import tempfile
+import shutil
+from openai import OpenAI
+import dotenv
+
+def generate_prompt(repo_url, role, repo_data, focus_areas=""):
+    """Generates the AI analysis prompt with repo details."""
+    return f"""
+    You are an AI expert in evaluating software engineering candidates based on their GitHub repositories. Your goal is to assess the quality, organization, and best practices of the submitted code repository. Below is the candidate's information:
+
+    ### Candidate Information:
+    - **Role Applied For**: {role}
+    - **GitHub Repository URL**: {repo_url}
+    - **Optional Key Focus Areas**: {focus_areas}
+
+    ### Repository Analysis:
+    You are provided with the repository's cloned structure and its contents. Analyze the following aspects:
+    {repo_data}
+
+    1. **Code Organization & Architecture** (20 points)
+    2. **Code Quality & Best Practices** (25 points)
+    3. **Language Proficiency & Best Practices** (20 points)
+    4. **Use of Frameworks & Libraries** (15 points)
+    5. **Testing & Documentation** (20 points)
+
+    ### **Final Score Calculation**
+    - Score the repository **out of 100** based on the criteria above.
+    - Justify the **score** by explaining the candidate’s strengths and weaknesses.
+
+    ### **Expected Output:**
+    - **Strengths**: What is done well?
+    - **Weaknesses**: What needs improvement?
+    - **Final Score (0-100)**: Provide a numeric score with an explanation.
+    - **Summary**: Briefly summarize the candidate’s proficiency based on this analysis.
+    """
+
+# Load environment variables
+dotenv.load_dotenv()
+client = OpenAI()
+
+PASSWORD = os.getenv("PASSWORD", "defaultpass")
+
+def authenticate(password):
+    """Check if the entered password is correct."""
+    if password != PASSWORD:
+        return "❌ Incorrect password! Access denied.", None
+    return None, "✅ Access granted! You may proceed."
+
+def analyze_repo(repo_url, role, focus_areas, password):
+    auth_error, auth_success = authenticate(password)
+    if auth_error:
+        return auth_error, gr.update(visible=False)  # If incorrect password, return error
+        
+    """Clone and analyze a GitHub repository with a loading state."""
+    if not repo_url.startswith("https://github.com/"):
+        return "❌ Invalid GitHub URL!", gr.update(visible=False)
+
+    # Extract repo details
+    repo_name = repo_url.split("/")[-1]
+    temp_dir = tempfile.mkdtemp()
+
+    try:
+        progress = gr.update(value="🔄 Cloning repository...", visible=True)
+        
+        # Clone the repo
+        repo_path = os.path.join(temp_dir, repo_name)
+        git.Repo.clone_from(repo_url, repo_path)
+        
+        progress = gr.update(value="📂 Analyzing repository structure...", visible=True)
+        
+        # Gather repository file structure and contents
+        repo_data = ""
+        file_count = 0  # Initialize file counter
+
+        for root, _, filenames in os.walk(repo_path):
+            for file in filenames:
+                file_count += 1  # Increment file counter
+                file_path = os.path.join(root, file)
+
+                try:
+                    with open(file_path, "r", encoding="utf-8") as f:
+                        file_content = f.read()
+                    repo_data += f"\n**File {file_count}:** {file_path.replace(repo_path, '')}\n```\n{file_content[:1000]}\n```\n"
+                except Exception:
+                    repo_data += f"\n**File {file_count}:** {file_path.replace(repo_path, '')} (⚠️ Cannot read binary file)\n"
+
+        progress = gr.update(value="🤖 Sending data to AI for evaluation...", visible=True)
+
+        # AI-based evaluation
+        evaluation = f"✅ **Evaluation for Role: {role}**\n\n"
+        evaluation += f"📂 Repository `{repo_name}` has `{file_count}` files.\n"
+        evaluation += f"💡 Key focus areas: {focus_areas}\n\n"
+        evaluation += "**🔍 Code Quality Analysis:**\n"
+        
+        completion = client.chat.completions.create(
+            model="o1",
+            messages=[
+                {
+                    "role": "user",
+                    "content": generate_prompt(repo_url, role, repo_data, focus_areas)
+                }
+            ]
+        )
+        
+        evaluation += "\n" + completion.choices[0].message.content
+
+        progress = gr.update(value="✅ Analysis complete!", visible=True)
+        return evaluation, progress
+
+    except Exception as e:
+        return f"❌ Error analyzing repository: {str(e)}", gr.update(visible=False)
+    
+    finally:
+        shutil.rmtree(temp_dir)  # Cleanup
+
+# Gradio UI
+with gr.Blocks() as app:
+    gr.Markdown("# 🛠️ AI-Powered Candidate Evaluation System")
+
+    password = gr.Textbox(label="Enter Password")
+    role = gr.Textbox(label="Role the Candidate is Applying For")
+    repo_url = gr.Textbox(label="GitHub Repository URL")
+    focus_areas = gr.Textbox(label="Optional Focus Areas (e.g., Clean Code, Performance)")
+
+    output = gr.Markdown()
+    progress = gr.Markdown(visible=False)  # Loader
+
+    submit_btn = gr.Button("🔍 Evaluate")
+
+    submit_btn.click(
+        fn=analyze_repo,
+        inputs=[repo_url, role, focus_areas, password],
+        outputs=[output, progress]
+    )
+
+app.launch()

requirements.txt

@@ -0,0 +1,58 @@
+aiofiles==23.2.1
+annotated-types==0.7.0
+anyio==4.8.0
+certifi==2025.1.31
+charset-normalizer==3.4.1
+click==8.1.8
+distro==1.9.0
+fastapi==0.115.8
+ffmpy==0.5.0
+filelock==3.17.0
+fsspec==2025.2.0
+gitdb==4.0.12
+GitPython==3.1.44
+gradio==5.15.0
+gradio_client==1.7.0
+h11==0.14.0
+httpcore==1.0.7
+httpx==0.28.1
+huggingface-hub==0.28.1
+idna==3.10
+Jinja2==3.1.5
+jiter==0.8.2
+markdown-it-py==3.0.0
+MarkupSafe==2.1.5
+mdurl==0.1.2
+numpy==2.2.2
+openai==1.61.1
+orjson==3.10.15
+packaging==24.2
+pandas==2.2.3
+pillow==11.1.0
+pydantic==2.10.6
+pydantic_core==2.27.2
+pydub==0.25.1
+Pygments==2.19.1
+python-dateutil==2.9.0.post0
+python-dotenv==1.0.1
+python-multipart==0.0.20
+pytz==2025.1
+PyYAML==6.0.2
+requests==2.32.3
+rich==13.9.4
+ruff==0.9.4
+safehttpx==0.1.6
+semantic-version==2.10.0
+shellingham==1.5.4
+six==1.17.0
+smmap==5.0.2
+sniffio==1.3.1
+starlette==0.45.3
+tomlkit==0.13.2
+tqdm==4.67.1
+typer==0.15.1
+typing_extensions==4.12.2
+tzdata==2025.1
+urllib3==2.3.0
+uvicorn==0.34.0
+websockets==14.2