An intelligent, automated system for finding and fixing open source bounty issues.
GitHub Bounty Agent automatically:
- 🔍 Finds suitable bounty issues from popular platforms (Gitcoin, GitHub, Algorand, etc.)
- 🧠 Analyzes issue requirements and project structure
- 🔧 Fixes code using OpenCode CLI integration
- ✅ Validates changes with tests and CI checks
- 📝 Creates high-quality Pull Requests following project conventions
- 🚀 Runs 24/7 processing 10+ bounty projects per day
| Platform | Average Bounty | Max Bounty | Total Paid |
|---|---|---|---|
| Gitcoin | $50 - $5,000 | $50,000+ | $50M+ |
| Ethereum Foundation | $500 - $250,000 | $250,000 | $1M+ |
| Solana Foundation | $100 - $50,000 | $2M | $200K+ |
| Algorand Foundation | $100 - $50,000 | $1M | $150K+ |
| Mozilla | $100 - $15,000 | $15,000 | $1M+ |
| Linux Kernel | $200 - $10,000 | $100,000 | Ongoing |
Realistic Monthly Earnings:
- Part-time (10-20 hrs/week): $500 - $3,000
- Full-time (40 hrs/week): $2,000 - $10,000
- Expert level: $5,000 - $50,000+
github-bounty-agent/
├── intelligent_bounty_agent.py # Main intelligent agent
├── opencode_bounty_agent.py # OpenCode CLI integration
├── opencode_integration.py # OpenCode client wrapper
├── simple_bounty_agent.py # Simplified agent
├── run_agent.py # Entry point script
├── run_continuous.py # 24/7 runner
├── bounty_projects_config.yaml # Bounty platforms config
├── requirements.txt # Python dependencies
└── .github/
└── workflows/
└── auto-bounty.yml # GitHub Actions workflow
- Python 3.10 or higher
- Git
- GitHub Personal Access Token (with
reposcope) - OpenCode CLI (optional, for advanced code analysis)
# Clone the repository
git clone https://github.com/robellliu-dev/github-bounty-agent.git
cd github-bounty-agent
# Install dependencies
pip install -r requirements.txt
# Set environment variables
export GITHUB_TOKEN="your_github_token_here"
export GITHUB_USERNAME="your_github_username"python3 intelligent_bounty_agent.pynohup python3 run_continuous.py > continuous.log 2>&1 &from intelligent_bounty_agent import IntelligentBountyAgent
from pathlib import Path
agent = IntelligentBountyAgent(
token="your_github_token",
username="your_username",
work_dir=Path("./workspace")
)
# Find and process one issue
issue = agent.find_issue()
result = agent.process_issue(issue)
if result["success"]:
print(f"PR created: {result['pr_info']['pr_url']}")# Process 10 issues
for i in range(10):
issue = agent.find_issue()
if issue:
result = agent.process_issue(issue)
print(f"Issue {i+1}: {'Success' if result['success'] else 'Failed'}")Edit bounty_projects_config.yaml:
defaults:
max_projects_per_run: 10
target_pr_count_per_day: 10
filters:
min_stars: 100
max_size_kb: 50000
preferred_labels:
- "good first issue"
- "help wanted"
- "bounty"The agent searches GitHub for issues with:
good first issuelabelhelp wantedlabelbountylabel- Low comment count (< 10)
- Recent activity
For each issue, the agent:
- Analyzes project structure (language, build system, tests)
- Extracts requirements from issue title and description
- Identifies relevant source files
- Classifies issue type (bug, feature, enhancement)
Using OpenCode CLI integration:
- Analyzes codebase context
- Generates fix plan
- Implements changes
- Validates with tests
Creates Pull Request with:
- Proper title format (following project conventions)
- Detailed description
- Issue linkage (Closes #123)
- Test results
- Checklist items
Each processed issue generates a detailed log:
pr_logs/pr_<owner>_<repo>_<issue_number>.log
Example log content:
======================================================================
ISSUE PROCESSING: Add Hindi and Tamil nutrient name aliases
Repository: Medinz01/nutrition-label-ocr
Issue: #2
URL: https://github.com/Medinz01/nutrition-label-ocr/issues/2
======================================================================
[1/7] Forking repository...
✅ Fork successful
[2/7] Cloning repository...
✅ Cloned to workspace/nutrition-label-ocr
[3/7] Analyzing project structure...
Language: Python
Build: pip
Key files: 15
[4/7] Understanding issue requirements...
Type: feature
Complexity: easy
Keywords: ['level', 'autocomplete', 'keyword']
[5/7] Finding relevant files...
Found 3 relevant files:
- semantic_parser.py
- iw4_builtins.json
- GscCompletionHandler.cs
[6/7] Creating feature branch...
✅ Branch: fix/issue-2-20260309120000
[7/7] Fixing the code...
✅ Code fixed successfully
Changes:
Added 'level' keyword to iw4_builtins.json
Added autocomplete support for level fields
[8/9] Committing and pushing...
✅ Committed and pushed
[9/9] Generating PR information...
======================================================================
PR INFORMATION
======================================================================
Title:
feat(aliases): add Hindi and Tamil nutrient name variants
Description:
...
PR Link:
https://github.com/Medinz01/nutrition-label-ocr/compare/main...
- Gitcoin Guide - Web3 bounties
- GitHub Sponsors - Direct sponsorships
- IssueHunt - Japanese bounty platform
- Start Small: Begin with
good first issuelabeled items - Read Guidelines: Always check CONTRIBUTING.md
- Test Locally: Run tests before submitting PR
- Clear Communication: Write detailed PR descriptions
- Be Patient: Wait for maintainer reviews
Contributions are welcome! Please:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit changes (
git commit -m 'feat: add amazing feature') - Push to branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- OpenCode AI for intelligent code analysis
- GitHub API for issue discovery
- All open source bounty platforms
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Email: robellliu.dev@gmail.com
- Support for more bounty platforms
- Enhanced code analysis with AI models
- Multi-language support
- Web dashboard for monitoring
- Slack/Discord notifications
- Bounty tracking and analytics
Made with ❤️ by robellliu-dev
⭐ If this project helps you earn bounties, please give it a star! ⭐