bun install # or npm / yarn / pnpm install
cp .env.sample .env.localThe following scripts are available for managing and analyzing grant applications:
bun run download-applicationsDownloads approved applications from specified Gitcoin Grants rounds and saves them locally. The script fetches data from multiple rounds across different chains (Celo and Arbitrum).
bun run download-karmagapFetches and saves historical grant data from KarmaHQ for each application. This helps in understanding a project's grant history and track record.
bun run download-hypercertsFetches and saves hypercerts data from Hypercerts foundation and ecocertain. This helps understanding the projects impact.
bun run research-projectsConducts in-depth research on grant applications using AI agents. The script generates detailed research reports for each project, helping evaluators understand the project's background and context.
bun run review-applicationsEvaluates grant applications using multiple AI agents with different evaluation criteria. Each agent provides an independent review based on the project's application, research data, and historical grant information.
The scripts work with the following directory structure:
applications/- Contains downloaded grant applicationsrounds/- Contains round-specific information- Each application directory contains:
application.json- Original application datakarmagap.json- Historical grant datahypercerts.json- Historical impact dataresearch.json- Research findingsreview-*.json- Individual agent reviews