Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
// Open-source code bounties posted as GitHub issues.
//
// Paid bounty platforms for open source (the largest routes payment through a
// GitHub app) mark a funded issue with a "💎 Bounty" label plus one "$N" label
// per pledge, and flip a "💰 Rewarded" label on once it is paid. The public
// issue search exposes all of it, so this adapter reads the label convention
// directly: no scraping, no account. An optional GITHUB_TOKEN raises the
// search quota from 10 to 30 requests a minute; the hourly refresh needs two.
import { fetchUpstreamJson } from '../../upstream-fetch.js';
import { cacheGet, cacheSet } from '../../cache.js';
import { markdownToText, parseUsdLabel, tagList } from '../normalize.js';
export const id = 'github';
export const label = 'GitHub code bounties';
export const venue = 'GitHub';
export const venueUrl = 'https://github.com';
const BOUNTY_LABEL = '💎 Bounty';
const REWARDED_LABEL = '💰 Rewarded';
const PAGES = 2;
const PER_PAGE = 50;
// The raw label search is dominated by freshly created repositories that open
// hundreds of "bounty" issues to farm agent pull requests. A repository has to
// look like a real project before its bounties reach the feed: some age, some
// community, not archived, and only a handful of listings each so one farm can
// never fill the page.
export const REPO_MIN_STARS = 25;
export const REPO_MIN_AGE_DAYS = 90;
export const PER_REPO_CAP = 5;
const REPO_META_TTL_S = 24 * 60 * 60;
const REPO_LOOKUPS_PER_REFRESH = 25;
// Labels that describe the work rather than the money or triage state.
const NOISE_LABELS = new Set(['bounty', 'help wanted', 'good first issue', 'enhancement', 'bug', 'feature', 'documentation']);
function authHeaders() {
const token = process.env.GITHUB_TOKEN || process.env.GH_TOKEN || '';
const h = { accept: 'application/vnd.github+json', 'user-agent': 'three.ws-bounty-feed' };
if (token) h.authorization = `Bearer ${token}`;
return h;
}
/** owner/repo from an issue's repository_url. */
function repoOf(issue) {
const m = /repos\/([^/]+\/[^/]+)$/.exec(String(issue.repository_url || ''));
return m ? m[1] : null;
}
/**
* Map one search hit to a listing. Pure.
* @param {any} issue
*/
export function mapIssue(issue) {
const labels = (issue.labels || []).map((l) => (typeof l === 'string' ? l : l?.name)).filter(Boolean);
if (!labels.includes(BOUNTY_LABEL)) return null;
const pledges = labels.map(parseUsdLabel).filter((n) => n != null);
const reward = pledges.length ? Math.max(...pledges) : null;
const rewarded = labels.includes(REWARDED_LABEL);
const repo = repoOf(issue);
const body = markdownToText(issue.body || '');
const skills = tagList(
labels.filter((l) => l !== BOUNTY_LABEL && l !== REWARDED_LABEL && parseUsdLabel(l) == null && !NOISE_LABELS.has(l.toLowerCase())),
);
return {
source: id,
externalId: String(issue.id),
kind: 'bounty',
title: issue.title,
summary: body ? body.slice(0, 400) : null,
body,
url: issue.html_url,
venue,
venueUrl: repo ? `https://github.com/${repo}` : venueUrl,
sponsor: repo,
sponsorLogo: issue.user?.avatar_url || null,
rewardAmount: reward,
rewardCurrency: reward != null ? 'USD' : null,
rewardUsd: reward,
deadline: null,
requirements: ['Open a pull request that resolves the issue and reference it in the PR description.'],
skills,
agentEligible: true,
submitMode: 'checklist',
status: rewarded || issue.state === 'closed' ? 'closed' : 'open',
submissionsCount: Number.isFinite(issue.comments) ? issue.comments : null,
raw: { repo, number: issue.number, labels, created_at: issue.created_at, updated_at: issue.updated_at },
};
}
/**
* Why a repository fails the quality gate, or null when it passes. Pure.
* @param {{ stars: number, created_at: string|null, archived: boolean }|null} meta
*/
export function repoRejection(meta, now = Date.now()) {
if (!meta) return 'unknown';
if (meta.archived) return 'archived';
if (!(meta.stars >= REPO_MIN_STARS)) return 'few_stars';
const created = meta.created_at ? Date.parse(meta.created_at) : NaN;
if (!Number.isFinite(created) || now - created < REPO_MIN_AGE_DAYS * 86_400_000) return 'too_new';
return null;
}
/**
* Keep listings from repositories that pass the gate, at most PER_REPO_CAP per
* repository (the most recently updated first, the order search returned). Pure.
*/
export function applyRepoGate(listings, metaByRepo, now = Date.now()) {
const perRepo = new Map();
const out = [];
for (const l of listings) {
const repo = l.raw?.repo;
if (!repo || repoRejection(metaByRepo.get(repo) || null, now)) continue;
const n = perRepo.get(repo) || 0;
if (n >= PER_REPO_CAP) continue;
perRepo.set(repo, n + 1);
out.push(l);
}
return out;
}
async function repoMeta(repo) {
const key = `bounties:gh-repo:${repo}`;
const hit = await cacheGet(key).catch(() => null);
if (hit) return hit;
const r = await fetchUpstreamJson(`https://api.github.com/repos/${repo}`, { headers: authHeaders() }, { name: 'bounties-github', timeoutMs: 8_000, label: 'github repo' });
const meta = { stars: Number(r?.stargazers_count) || 0, created_at: r?.created_at || null, archived: Boolean(r?.archived) };
await cacheSet(key, meta, REPO_META_TTL_S).catch(() => {});
return meta;
}
/** Repository metadata for every repo in `listings`, bounded per refresh. */
async function loadRepoMeta(listings) {
const repos = [...new Set(listings.map((l) => l.raw?.repo).filter(Boolean))].slice(0, REPO_LOOKUPS_PER_REFRESH);
const out = new Map();
await Promise.all(
repos.map(async (repo) => {
try {
out.set(repo, await repoMeta(repo));
} catch {
// An unreadable repository is left out of this refresh, never let through.
}
}),
);
return out;
}
export async function fetchListings() {
const q = encodeURIComponent(`label:"${BOUNTY_LABEL}" -label:"${REWARDED_LABEL}" state:open is:issue`);
const out = [];
for (let page = 1; page <= PAGES; page++) {
const url = `https://api.github.com/search/issues?q=${q}&sort=updated&order=desc&per_page=${PER_PAGE}&page=${page}`;
const data = await fetchUpstreamJson(url, { headers: authHeaders() }, { name: 'bounties-github', timeoutMs: 12_000, label: 'github bounty search' });
const items = Array.isArray(data?.items) ? data.items : [];
for (const it of items) {
const l = mapIssue(it);
if (l) out.push(l);
}
if (items.length < PER_PAGE) break;
}
return applyRepoGate(out, await loadRepoMeta(out));
}
/**
* Live payout state of one issue: the venue marks a paid bounty "💰 Rewarded".
* @param {{ repo: string, number: number }} ref
*/
export async function payoutStatus(ref) {
const issue = await fetchUpstreamJson(`https://api.github.com/repos/${ref.repo}/issues/${ref.number}`, { headers: authHeaders() }, {
name: 'bounties-github',
label: 'github issue',
});
const labels = (issue.labels || []).map((l) => (typeof l === 'string' ? l : l?.name));
return {
paid: labels.includes(REWARDED_LABEL),
state: issue.state,
closed_at: issue.closed_at || null,
pledges_usd: labels.map(parseUsdLabel).filter((n) => n != null),
url: issue.html_url,
};
}