Documentation

Quick Start

Follow this guide to set up JudgeNod, configure your first rubric, and deploy the judging infrastructure for your hackathon.

— The JudgeNod deployment and evaluation workflow.

Install the JudgeNod CLI

The JudgeNod CLI is the primary tool for administrators to manage rubrics and for judges to evaluate repositories.

npm install -g @judgenod/cli

Verify the installation by checking the version:

judgenod --version

Initialize your workspace

Create a new directory for your hackathon and initialize the configuration. This will create a `judgenod.config.json` file.

mkdir global-builders-hackathon cd global-builders-hackathon judgenod init

Ensure you have a Solana wallet (JSON keypair) with sufficient SOL for deployment. JudgeNod will use your default Solana config (~/.config/solana/id.json) unless specified otherwise.

Configure the Rubric

Open `judgenod.config.json` and define your scoring categories. You can weight criteria based on your hackathon's specific goals.

judgenod.config.json

{ "project": "Global Builders", "criteria": [ { "name": "Technical Innovation", "weight": 40, "max_score": 10 }, { "name": "UX/UI Design", "weight": 30, "max_score": 10 }, { "name": "Solana Integration", "weight": 30, "max_score": 10 } ] }

Deploy the Judge Contract

Deploy your rubrics as a stateful smart contract on Solana. This ensures that the scoring rules cannot be changed after judging begins.

judgenod deploy --network mainnet

Deployment successful! Contract ID: `9vBoPV2...LZ2HH6BfBLvnm2`. You are now ready to start evaluating projects.

Next Steps

Architecture →

Understand the scoring engine logic.

Smart Contracts →

Security best practices and audit reports.

Last updated: April 16, 2026

Edit this page on GitHub &nearr;