Overview

Project docs — honest and short

This is not a full docs portal. Below is what Gridnull is and how evaluation access works; detailed install.md ships with the bundle after contact.

What Gridnull is

On-prem backlog metrics for GitHub and GitLab: sync issue metadata to Postgres, surface stale and stuck work plus milestone decay, optional local Ollama suggestions with human-approved write-back, and a Grid Map view of issue similarity. Issue text is not sent to a vendor cloud for AI.

Prerequisites

Docker and Docker Compose on a Linux host you control
Roughly 8 GB RAM recommended if you enable local Ollama (less without LLM)
GitHub or GitLab OAuth app + PAT with scopes matching sync / optional write-back
Outbound HTTPS to your VCS and to GHCR for image pulls (registry read token provided individually after contact)

Install via bundle (on request)

After email agreement, you receive the gridnull-install ZIP (compose, .env.example, install.md, legal texts) and GHCR pull access for gridnull-web / gridnull-worker. Configure .env, pull images, run migrations, open /setup — no git clone of the product source.