bun install # or npm / yarn / pnpm install
cp .env.sample .env.local
The following scripts are available for managing and analyzing grant applications:
bun run download-applications
Downloads 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-karmagap
Fetches 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-hypercerts
Fetches and saves hypercerts data from Hypercerts foundation and ecocertain. This helps understanding the projects impact.
bun run research-projects
Conducts 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-applications
Evaluates 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