🤖 Automated GitHub Issue Fixer

An AI-powered Apify Actor that automatically monitors GitHub repositories, analyzes issues, creates fixes, generates pull requests, and sends email notifications.

✨ Features

• 🔍 Continuous Monitoring: Actively monitors your GitHub repository for new issues
• 🧠 AI-Powered Analysis: Uses Google Gemini AI to analyze issues and understand your codebase
• 🔧 Automatic Fixes: Generates code fixes based on issue descriptions and repository context
• 🌿 Branch Management: Creates dedicated branches for each fix
• 📝 Pull Request Creation: Automatically creates well-documented pull requests
• 📧 Email Notifications: Sends detailed email notifications about fixes and PRs
• 🔄 Auto-Merge Option: Optionally auto-merge PRs (use with caution!)

🚀 How It Works

1. Issue Detection: The Actor continuously polls your GitHub repository for new issues
2. Code Analysis: When a new issue is found, Gemini AI analyzes the issue description and relevant code files
3. Fix Generation: AI generates appropriate code changes to fix the issue
4. Branch Creation: Creates a new branch with a descriptive name (e.g., fix/issue-123)
5. Code Application: Applies the generated fixes to the codebase
6. PR Creation: Creates a pull request with detailed explanation of the fix
7. Notification: Sends an email notification with links to the issue and PR
8. Optional Auto-Merge: If enabled, automatically merges the PR

📋 Prerequisites

Before using this Actor, you'll need:

1. GitHub Personal Access Token

   • Go to GitHub Settings → Developer settings → Personal access tokens
   • Create a token with repo, workflow, and user:email permissions

2. Google Gemini API Key

   • Visit Google AI Studio
   • Create an API key for Gemini

3. Email Account for Notifications

   • SMTP server details (e.g., Gmail: smtp.gmail.com:587)
   • Email address and password/app-specific password

⚙️ Configuration

Required Inputs

Field	Description	Example
githubRepoUrl	Full URL of the GitHub repository to monitor	https://github.com/username/repo
githubToken	GitHub Personal Access Token	ghp_xxxxxxxxxxxx
geminiApiKey	Google Gemini API Key	AIzaSyxxxxxxxxxx
smtpServer	SMTP server address	smtp.gmail.com
emailFrom	Email address to send from	bot@example.com
emailPassword	Email password or app-specific password	xxxxxxxxxxxx
notificationEmail	Email to receive notifications	developer@example.com

Optional Inputs

Field	Description	Default
smtpPort	SMTP server port	587
pollingIntervalMinutes	How often to check for new issues (1-60 minutes)	5
autoMerge	Automatically merge PRs after creation	false
maxIssuesPerRun	Maximum issues to process per iteration	5

📖 Usage

On Apify Platform

1. Go to the Actor page
2. Click "Try for free"
3. Fill in the required configuration
4. Click "Start"
5. The Actor will run continuously, monitoring for new issues

Local Development

# Install Apify CLI
npm install -g apify-cli

# Clone the Actor
apify pull

# Install dependencies (done via Docker)
# No need to run pip install manually

# Build the Docker image
docker build -t github-issue-fixer .

# Run locally with Docker
docker run -it --rm \
  -e APIFY_INPUT_JSON='{"githubRepoUrl":"...","githubToken":"..."}' \
  github-issue-fixer

# Or use Apify CLI (which uses Docker)
apify run

🔒 Security Considerations

[!WARNING] Auto-Merge: The auto-merge feature should be used with extreme caution. It's recommended to keep this disabled and manually review PRs before merging.

[!IMPORTANT] API Keys: Keep your GitHub token, Gemini API key, and email credentials secure. Use Apify's secret input fields to store sensitive data.

[!TIP] Testing: Test the Actor on a non-critical repository first to ensure it works as expected.

📊 Output

The Actor saves the following data to the dataset for each processed issue:

{
  "timestamp": "2025-12-15T18:30:00.000Z",
  "issue_number": 42,
  "issue_title": "Fix login bug",
  "issue_url": "https://github.com/user/repo/issues/42",
  "status": "success",
  "iteration": 1
}

🛠️ Technical Stack

• Python 3.13: Core language
• Apify SDK: Actor framework
• PyGithub: GitHub API integration
• Google Generative AI: Gemini AI for code analysis
• GitPython: Local git operations
• aiosmtplib: Async email sending

📝 Example Workflow

1. A user creates an issue: "Fix the login button not working on mobile"
2. The Actor detects the new issue within 5 minutes (default polling interval)
3. Gemini AI analyzes the issue and relevant code files
4. AI generates a fix (e.g., updating CSS for mobile responsiveness)
5. Actor creates branch fix/issue-42
6. Applies the fix and commits with message: "Fix issue #42: Fix login button on mobile"
7. Pushes to GitHub and creates PR
8. Sends email to developer with links to issue and PR
9. Developer reviews PR and merges if satisfied

🆘 Support

For issues or questions:

• Email: ashutoshsahoo556@gmail.com