🤖 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 bash # 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: json { "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