mirror of https://github.com/Shubhamsaboo/awesome-llm-apps.git synced 2026-06-01 08:50:23 +00:00

Files

T

History

TechTide AI 156511e749 fix: remove stdlib modules from requirements.txt

asyncio and uuid are Python standard library modules (available since
Python 3.4+). Listing them in requirements.txt is unnecessary and can
install unrelated PyPI packages with the same name, causing conflicts.

Affected files (8 total):
- starter_ai_agents: openai_research_agent, mixture_of_agents,
  ai_meme_generator_agent_browseruse
- mcp_ai_agents: github_mcp_agent, browser_mcp_agent
- ai_agent_framework_crash_course: 5_1_in_memory_conversation_agent,
  5_2_persistent_conversation_agent
- advanced_ai_agents: ai_financial_coach_agent

2026-05-21 17:26:10 -04:00

github_agent.py

refactor: Update travel planner and GitHub agent to use RunOutput and enhance requirements

2025-11-09 15:02:32 -08:00

README.md

chore: enhance README files across multiple agent applications by adding links to free step-by-step tutorials, providing users with comprehensive guidance on building each agent from scratch.

2025-11-27 21:58:03 -08:00

requirements.txt

fix: remove stdlib modules from requirements.txt

2026-05-21 17:26:10 -04:00

README.md

🐙 GitHub MCP Agent

🎓 FREE Step-by-Step Tutorial

👉 Click here to follow our complete step-by-step tutorial and learn how to build this from scratch with detailed code walkthroughs, explanations, and best practices.

A Streamlit application that allows you to explore and analyze GitHub repositories using natural language queries through the Model Context Protocol (MCP).

✨ Now using the official GitHub MCP Server from GitHub!

Features

Natural Language Interface: Ask questions about repositories in plain English
Comprehensive Analysis: Explore issues, pull requests, repository activity, and code statistics
Interactive UI: User-friendly interface with example queries and custom input
MCP Integration: Leverages the Model Context Protocol to interact with GitHub's API
Real-time Results: Get immediate insights on repository activity and health

Setup

Requirements

Python 3.8+
Docker (for official GitHub MCP server)
- Download and install from docker.com
- Make sure Docker is running before starting the app
OpenAI API Key
GitHub Personal Access Token

Installation

Clone this repository:

git clone https://github.com/Shubhamsaboo/awesome-llm-apps.git
cd mcp-github-agent

Install the required Python packages:
```
pip install -r requirements.txt
```
Verify Docker is installed and running:
```
docker --version
docker ps
```
Get your API keys:
- OpenAI API Key: Get from platform.openai.com/api-keys
- GitHub Token: Create at github.com/settings/tokens with repo scope

Running the App

Start the Streamlit app:
```
streamlit run github_agent.py
```
In the app interface:
- Enter your OpenAI API key
- Enter your GitHub token
- Specify a repository to analyze
- Select a query type or write your own
- Click "Run Query"

Example Queries

Issues

"Show me issues by label"
"What issues are being actively discussed?"
"Find issues labeled as bugs"

Pull Requests

"What PRs need review?"
"Show me recent merged PRs"
"Find PRs with conflicts"

Repository

"Show repository health metrics"
"Show repository activity patterns"
"Analyze code quality trends"