Merge pull request #684 from Dhivya-Bharathy/add-github-repo-analyzer-agent

Add GitHub repo analyzer agent

Author: MervinPraison

examples/python/tools/exa-tool/github_repo_analyzer_agent.py

@@ -0,0 +1,69 @@
+# # -*- coding: utf-8 -*-
+# """github_repo_analyzer_agent.ipynb
+
+# Automatically generated by Colab.
+
+# Original file is located at
+#     https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/github_repo_analyzer_agent.ipynb
+
+# # 🤖 GitHub Repo Analyzer Agent
+# AI agent powered by PraisonAI and OpenAI to analyze GitHub repositories using GitHub API.
+
+# [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/DhivyaBharathy-web/PraisonAI/blob/main/examples/cookbooks/github_repo_analyzer_agent.ipynb)
+
+# # 📦 Install dependencies
+# """
+
+# !pip install praisonaiagents openai requests
+
+# """# Tools Used
+
+# 🧠 praisonaiagents – Smart AI agent
+
+# 🔗 openai – GPT-powered responses
+
+# 📂 requests – GitHub repo analysis
+
+# 🖥️ Python I/O – Interactive CLI in notebook
+
+# # 🔐 Set OpenAI API Key
+# """
+
+import os
+if not os.getenv("OPENAI_API_KEY"):
+    os.environ["OPENAI_API_KEY"] = input("🔐 Enter your OpenAI API key: ")
+
+# """# 🧠 Imports"""
+
+import requests
+import openai
+from praisonaiagents import Agent
+
+openai.api_key = os.environ["OPENAI_API_KEY"]
+
+# """# 🤖 Create the Agent"""
+
+agent = Agent(instructions="""
+You are a GitHub codebase explainer. When given a repo URL, fetch summary of
+its files and provide insightful analysis. Be helpful and concise.
+""")
+
+# """# 📂 Fetch GitHub repo file names"""
+
+def fetch_repo_files(repo_url):
+    api_url = repo_url.replace("https://github.com", "https://api.github.com/repos") + "/contents"
+    r = requests.get(api_url)
+    return [f["name"] for f in r.json()] if r.status_code == 200 else []
+
+# """# 💬 Ask Agent"""
+
+def ask_agent(repo_url):
+    files = fetch_repo_files(repo_url)
+    if not files:
+        return "❌ Cannot fetch repo contents."
+    return agent.start(f"Repo contains files: {files}. Analyze key components and structure.")
+
+# """# 🧪 Run the agent"""
+
+repo = input("🔗 Enter GitHub repository URL: ")
+print("\n🧠 Agent Insight:\n", ask_agent(repo))

examples/python/tools/exa-tool/personalized_learning_assistant.py

@@ -0,0 +1,69 @@
+# ===============================
+# 1. 📘 Project Title & Purpose
+# ===============================
+# """
+# AI‑Powered Personalized Learning Assistant with Smart Content Chatbot
+
+# This assistant helps users learn any topic by chatting with an AI tutor. 
+# It uses PraisonAI Agents, OpenAI API, and Transformers to deliver answers clearly.
+# """
+
+# ============================
+# 2. 📦 Dependencies Required
+# ============================
+# """
+# Required Libraries:
+# - praisonaiagents
+# - openai
+# - transformers
+
+# Make sure to install these in Colab or terminal:
+# !pip install praisonaiagents openai transformers
+# """
+
+# =====================
+# 3. 🧰 Tools Used
+# =====================
+# """
+# ✅ praisonaiagents – Builds the smart tutoring agent  
+# ✅ openai – Uses OpenAI GPT for accurate answers  
+# ✅ transformers – Fallback model using GPT-2  
+# ✅ Python I/O – Simple interactive CLI using input/print
+# """
+
+# ============================
+# 4. 🔐 Set OpenAI API Key
+# ============================
+import os
+os.environ['OPENAI_API_KEY'] = input('Enter your OpenAI API key: ')
+
+# ================================
+# 5. 🧠 Initialize AI Agent + Fallback
+# ================================
+from praisonaiagents import Agent
+from transformers import pipeline as hf_pipeline
+import openai
+
+openai.api_key = os.getenv('OPENAI_API_KEY')
+hf_chatbot = hf_pipeline('text-generation', model='gpt2')
+
+agent = Agent(instructions='You are a friendly tutor. Answer learner questions clearly and helpfully.')
+
+def chat_with_ai(user_input):
+    try:
+        return agent.start(user_input)
+    except Exception as e:
+        print('[Fallback GPT-2]', e)
+        return hf_chatbot(user_input, max_length=100)[0]['generated_text']
+
+# ============================
+# 6. 💬 Interactive Chat Loop
+# ============================
+print("Start chatting with your AI tutor! Type 'exit' to quit.")
+while True:
+    user_input = input('You: ')
+    if user_input.lower() in ['exit', 'quit']:
+        print('Goodbye! Happy learning!')
+        break
+    response = chat_with_ai(user_input)
+    print('🤖 Tutor:', response)