feat: add AI worker workflows (Gemini + Jules)
Distributed AI compute using contributor's free tiers:
Gemini 2.0 Flash (ai-worker.yml):
- 1500 req/day free from Google
- Code review, security scan, bug detection
- Contributor sets GEMINI_API_KEY in fork secrets
Jules/Copilot (jules-dispatch.yml):
- Triggered by @jules or /jules comments
- Creates PRs to fix issues automatically
- Uses contributor's Copilot allowance (free for OSS)
Documentation (doc/free-tier-compute.md):
- Setup guide for all free tiers
- Compute distribution model diagram
- Donor fleet instructions
Innocent strategy: Jules commits fixes to contributor's fork 😇
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Snider
parent
c03c49a539
commit
a78ef46133
3 changed files with 293 additions and 0 deletions
126
.github/workflows/ai-worker.yml
vendored
Normal file
126
.github/workflows/ai-worker.yml
vendored
Normal file
|
|
@ -0,0 +1,126 @@
|
||||||
|
name: AI Worker (Free Tier)
|
||||||
|
|
||||||
|
# Runs on contributor's fork - uses THEIR API allowances
|
||||||
|
# Gemini 2.0 Flash: 1500 req/day free
|
||||||
|
# Jules: Available to all GitHub users
|
||||||
|
|
||||||
|
on:
|
||||||
|
pull_request:
|
||||||
|
types: [opened, synchronize]
|
||||||
|
issues:
|
||||||
|
types: [labeled]
|
||||||
|
|
||||||
|
permissions:
|
||||||
|
contents: write
|
||||||
|
pull-requests: write
|
||||||
|
issues: write
|
||||||
|
|
||||||
|
env:
|
||||||
|
# Contributors set their own GEMINI_API_KEY in fork secrets
|
||||||
|
# Free tier: 1500 requests/day, 1M tokens/min
|
||||||
|
GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
# Analyze PR with Gemini (contributor's free tier)
|
||||||
|
gemini-review:
|
||||||
|
if: github.event_name == 'pull_request'
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
with:
|
||||||
|
fetch-depth: 0
|
||||||
|
|
||||||
|
- name: Get diff
|
||||||
|
id: diff
|
||||||
|
run: |
|
||||||
|
DIFF=$(git diff origin/${{ github.base_ref }}...HEAD | head -c 50000)
|
||||||
|
echo "diff<<EOFMARKER" >> $GITHUB_OUTPUT
|
||||||
|
echo "$DIFF" >> $GITHUB_OUTPUT
|
||||||
|
echo "EOFMARKER" >> $GITHUB_OUTPUT
|
||||||
|
|
||||||
|
- name: Gemini Analysis
|
||||||
|
if: env.GEMINI_API_KEY != ''
|
||||||
|
id: gemini
|
||||||
|
run: |
|
||||||
|
# Call Gemini 2.0 Flash (free tier)
|
||||||
|
RESPONSE=$(curl -s "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash-exp:generateContent?key=$GEMINI_API_KEY" \
|
||||||
|
-H 'Content-Type: application/json' \
|
||||||
|
-d @- << 'PAYLOAD'
|
||||||
|
{
|
||||||
|
"contents": [{
|
||||||
|
"parts": [{
|
||||||
|
"text": "Review this code diff. Be concise. List: 1) Security issues 2) Bugs 3) Improvements. If none, say 'LGTM'.\n\nDiff:\n${{ steps.diff.outputs.diff }}"
|
||||||
|
}]
|
||||||
|
}],
|
||||||
|
"generationConfig": {
|
||||||
|
"temperature": 0.2,
|
||||||
|
"maxOutputTokens": 1000
|
||||||
|
}
|
||||||
|
}
|
||||||
|
PAYLOAD
|
||||||
|
)
|
||||||
|
|
||||||
|
# Extract text from response
|
||||||
|
REVIEW=$(echo "$RESPONSE" | jq -r '.candidates[0].content.parts[0].text // "Analysis failed"')
|
||||||
|
echo "review<<EOFMARKER" >> $GITHUB_OUTPUT
|
||||||
|
echo "$REVIEW" >> $GITHUB_OUTPUT
|
||||||
|
echo "EOFMARKER" >> $GITHUB_OUTPUT
|
||||||
|
|
||||||
|
- name: Post Gemini review
|
||||||
|
if: steps.gemini.outputs.review != ''
|
||||||
|
uses: actions/github-script@v7
|
||||||
|
with:
|
||||||
|
script: |
|
||||||
|
const review = `${{ steps.gemini.outputs.review }}`;
|
||||||
|
await github.rest.issues.createComment({
|
||||||
|
owner: context.repo.owner,
|
||||||
|
repo: context.repo.repo,
|
||||||
|
issue_number: context.issue.number,
|
||||||
|
body: `## 🤖 Gemini Analysis (Free Tier)\n\n${review}\n\n---\n_Powered by contributor's Gemini API allowance (1500 req/day free)_`
|
||||||
|
});
|
||||||
|
|
||||||
|
# Trigger Jules to fix issues (contributor's Copilot allowance)
|
||||||
|
trigger-jules:
|
||||||
|
if: github.event_name == 'issues' && github.event.label.name == 'agent:ready'
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- name: Check Jules eligibility
|
||||||
|
id: check
|
||||||
|
uses: actions/github-script@v7
|
||||||
|
with:
|
||||||
|
script: |
|
||||||
|
// Check if this repo has Copilot coding agent enabled
|
||||||
|
const issue = context.payload.issue;
|
||||||
|
|
||||||
|
console.log(`Issue #${issue.number}: ${issue.title}`);
|
||||||
|
console.log(`Labels: ${issue.labels.map(l => l.name).join(', ')}`);
|
||||||
|
|
||||||
|
// Jules can be assigned to issues with specific labels
|
||||||
|
const hasAgentic = issue.labels.some(l => l.name === 'agentic');
|
||||||
|
|
||||||
|
return { eligible: hasAgentic, issueNumber: issue.number };
|
||||||
|
|
||||||
|
- name: Assign to Jules
|
||||||
|
if: steps.check.outputs.result != ''
|
||||||
|
uses: actions/github-script@v7
|
||||||
|
with:
|
||||||
|
script: |
|
||||||
|
// Trigger Jules by adding the copilot label
|
||||||
|
// Jules will pick up the issue and create a PR
|
||||||
|
try {
|
||||||
|
await github.rest.issues.addLabels({
|
||||||
|
owner: context.repo.owner,
|
||||||
|
repo: context.repo.repo,
|
||||||
|
issue_number: context.payload.issue.number,
|
||||||
|
labels: ['copilot'] // This triggers Jules/Copilot coding agent
|
||||||
|
});
|
||||||
|
|
||||||
|
await github.rest.issues.createComment({
|
||||||
|
owner: context.repo.owner,
|
||||||
|
repo: context.repo.repo,
|
||||||
|
issue_number: context.payload.issue.number,
|
||||||
|
body: `## 🤖 Jules Activated\n\nThis issue has been assigned to GitHub Copilot coding agent (Jules).\n\nJules will:\n1. Analyze the issue\n2. Create a solution\n3. Open a PR with the fix\n\n_Using contributor's Copilot allowance_ 🆓`
|
||||||
|
});
|
||||||
|
} catch (e) {
|
||||||
|
console.log('Could not assign to Jules:', e.message);
|
||||||
|
}
|
||||||
64
.github/workflows/jules-dispatch.yml
vendored
Normal file
64
.github/workflows/jules-dispatch.yml
vendored
Normal file
|
|
@ -0,0 +1,64 @@
|
||||||
|
name: Jules Task Dispatch
|
||||||
|
|
||||||
|
# Dispatch tasks to Jules (Copilot coding agent)
|
||||||
|
# Jules works on the contributor's fork using their Copilot Pro allowance
|
||||||
|
|
||||||
|
on:
|
||||||
|
issue_comment:
|
||||||
|
types: [created]
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
dispatch-to-jules:
|
||||||
|
# Trigger when someone comments "@jules" or "/jules"
|
||||||
|
if: contains(github.event.comment.body, '@jules') || contains(github.event.comment.body, '/jules')
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
permissions:
|
||||||
|
issues: write
|
||||||
|
pull-requests: write
|
||||||
|
steps:
|
||||||
|
- name: Parse Jules command
|
||||||
|
id: parse
|
||||||
|
uses: actions/github-script@v7
|
||||||
|
with:
|
||||||
|
script: |
|
||||||
|
const comment = context.payload.comment.body;
|
||||||
|
|
||||||
|
// Extract task from comment
|
||||||
|
// Format: @jules <task description>
|
||||||
|
// or: /jules fix the bug in auth.php
|
||||||
|
const match = comment.match(/(?:@jules|\/jules)\s+(.+)/i);
|
||||||
|
const task = match ? match[1].trim() : null;
|
||||||
|
|
||||||
|
return { task, commenter: context.payload.comment.user.login };
|
||||||
|
|
||||||
|
- name: Create Jules task
|
||||||
|
uses: actions/github-script@v7
|
||||||
|
with:
|
||||||
|
script: |
|
||||||
|
const result = ${{ steps.parse.outputs.result }};
|
||||||
|
|
||||||
|
if (!result.task) {
|
||||||
|
await github.rest.issues.createComment({
|
||||||
|
owner: context.repo.owner,
|
||||||
|
repo: context.repo.repo,
|
||||||
|
issue_number: context.issue.number,
|
||||||
|
body: `@${result.commenter} Please specify a task for Jules:\n\n\`@jules fix the authentication bug\`\n\`@jules add unit tests for User model\`\n\`@jules refactor this to use async/await\``
|
||||||
|
});
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Add copilot label to trigger Jules
|
||||||
|
await github.rest.issues.addLabels({
|
||||||
|
owner: context.repo.owner,
|
||||||
|
repo: context.repo.repo,
|
||||||
|
issue_number: context.issue.number,
|
||||||
|
labels: ['copilot', 'agent:wip']
|
||||||
|
});
|
||||||
|
|
||||||
|
// Create a sub-issue or task for Jules
|
||||||
|
await github.rest.issues.createComment({
|
||||||
|
owner: context.repo.owner,
|
||||||
|
repo: context.repo.repo,
|
||||||
|
issue_number: context.issue.number,
|
||||||
|
body: `## 🤖 Jules Task Queued\n\n**Task:** ${result.task}\n**Requested by:** @${result.commenter}\n\nJules (Copilot coding agent) will work on this using the repository owner's Copilot allowance.\n\n---\n_Tip: Fork this repo to use your own Copilot Pro allowance for faster processing._`
|
||||||
|
});
|
||||||
103
doc/free-tier-compute.md
Normal file
103
doc/free-tier-compute.md
Normal file
|
|
@ -0,0 +1,103 @@
|
||||||
|
# Free Tier Compute Guide
|
||||||
|
|
||||||
|
This project uses distributed compute from contributors' free tier allowances. Here's how to maximize it.
|
||||||
|
|
||||||
|
## GitHub Actions (Microsoft)
|
||||||
|
|
||||||
|
**Free tier:** 2,000 minutes/month for public repos
|
||||||
|
|
||||||
|
When you fork this repo, CI runs on YOUR allowance, not upstream's. This includes:
|
||||||
|
- Full test suite
|
||||||
|
- Linting and formatting
|
||||||
|
- Security scanning
|
||||||
|
- AI-powered triage
|
||||||
|
|
||||||
|
## Gemini API (Google)
|
||||||
|
|
||||||
|
**Free tier:** 1,500 requests/day, 1M tokens/minute
|
||||||
|
|
||||||
|
### Setup
|
||||||
|
|
||||||
|
1. Get API key: https://aistudio.google.com/apikey
|
||||||
|
2. Add to your fork's secrets:
|
||||||
|
```bash
|
||||||
|
gh secret set GEMINI_API_KEY --repo YOUR_USER/YOUR_FORK
|
||||||
|
```
|
||||||
|
|
||||||
|
The `ai-worker.yml` workflow will use your Gemini allowance for:
|
||||||
|
- Code review
|
||||||
|
- Bug detection
|
||||||
|
- Security analysis
|
||||||
|
|
||||||
|
## Jules / Copilot (GitHub)
|
||||||
|
|
||||||
|
**Free tier:** Available with GitHub Copilot (free for OSS contributors)
|
||||||
|
|
||||||
|
### Trigger Jules
|
||||||
|
|
||||||
|
Comment on any issue:
|
||||||
|
```
|
||||||
|
@jules fix the authentication bug in login.php
|
||||||
|
@jules add unit tests for the User model
|
||||||
|
@jules refactor to use async/await
|
||||||
|
```
|
||||||
|
|
||||||
|
Jules will:
|
||||||
|
1. Analyze the issue
|
||||||
|
2. Write code to fix it
|
||||||
|
3. Create a PR on your fork
|
||||||
|
4. Uses YOUR Copilot allowance
|
||||||
|
|
||||||
|
### Get Copilot Free
|
||||||
|
|
||||||
|
- Open source contributors: https://github.com/settings/copilot
|
||||||
|
- Students: GitHub Education pack
|
||||||
|
- Verified OSS maintainers: Free Copilot Pro
|
||||||
|
|
||||||
|
## CodeRabbit
|
||||||
|
|
||||||
|
**Free tier:** Unlimited for public repos
|
||||||
|
|
||||||
|
Already configured via `.coderabbit.yaml`. Reviews run automatically on PRs.
|
||||||
|
|
||||||
|
## Compute Distribution Model
|
||||||
|
|
||||||
|
```
|
||||||
|
┌────────────────────────────────────────────┐
|
||||||
|
│ CONTRIBUTOR FORK │
|
||||||
|
│ │
|
||||||
|
│ ┌─────────────┐ ┌─────────────┐ │
|
||||||
|
│ │ GitHub │ │ Gemini │ │
|
||||||
|
│ │ Actions │ │ 2.0 Flash │ │
|
||||||
|
│ │ FREE │ │ FREE │ │
|
||||||
|
│ └─────────────┘ └─────────────┘ │
|
||||||
|
│ │
|
||||||
|
│ ┌─────────────┐ ┌─────────────┐ │
|
||||||
|
│ │ Jules/ │ │ CodeRabbit │ │
|
||||||
|
│ │ Copilot │ │ FREE │ │
|
||||||
|
│ │ FREE* │ │ │ │
|
||||||
|
│ └─────────────┘ └─────────────┘ │
|
||||||
|
│ │
|
||||||
|
│ * With Copilot Pro (free for OSS) │
|
||||||
|
└────────────────────────────────────────────┘
|
||||||
|
│
|
||||||
|
│ PR (already analyzed)
|
||||||
|
▼
|
||||||
|
┌────────────────────────────────────────────┐
|
||||||
|
│ UPSTREAM REPO │
|
||||||
|
│ │
|
||||||
|
│ Just verify fork CI passed ✓ │
|
||||||
|
│ Cost: ~$0.001 per PR │
|
||||||
|
└────────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
## For Donor Fleet Members
|
||||||
|
|
||||||
|
If you want to contribute compute without coding:
|
||||||
|
|
||||||
|
1. Fork the repo
|
||||||
|
2. Set up your API keys (Gemini, etc.)
|
||||||
|
3. Keep Actions enabled
|
||||||
|
4. Pick up `agent:review` tasks to verify others' work
|
||||||
|
|
||||||
|
Your free tier becomes part of the distributed compute network!
|
||||||
Loading…
Add table
Reference in a new issue