neutree-ai/neutreeNew scan
97/ 100 · A

Polished and well engineered. Punching above its star count.

Enterprise-grade Private Model-as-a-Service Platform

Go118 starsApache-2.0updated today

Outstanding work. A score of 97/100 puts this repo in a very small tier of truly well-engineered open source projects.

DocumentationREADME, setup, examples, license
92
EngineeringTests, CI, linting, lockfiles
98
Project healthDescription, activity, stars, deps
100

What to fix first

The highest-impact improvements for this repo.

  1. 1
    CI/CD
    EngineeringInfo

    Add `tsc --noEmit`, `mypy`, or `cargo check` to catch type errors before they merge.

  2. 2
    README
    DocumentationIssue

    Add CI/build status badges from shields.io or your CI provider to signal project health.

  3. 3
    Reproducibility
    EngineeringIssue

    Add .github/dependabot.yml with at least one package-ecosystem entry so dependencies are updated automatically.

Detailed breakdown

Documentation

92
  • README90
    • README is present.
    • README is well structured with multiple sections.
    • README includes screenshots or visuals. Great for first impressions.
    • README has code examples.
    • README links to a live demo or deployed app.
    • No status badges in the README (−10 pts).Add CI/build status badges from shields.io or your CI provider to signal project health.
  • Install and run instructions100
    • README documents how to install the project.
    • README documents how to run the project.
    • .env.example is present. Contributors can see exactly which env vars to set.
  • License100
    • Licensed under Apache-2.0.
  • Contributing guide72
    • CONTRIBUTING guide found.
    • CONTRIBUTING guide contents could not be read (−28 pts vs a readable file).Move the file to the repo root or docs/CONTRIBUTING.md so its setup, style, test, and PR sections can be graded.
    • Optional: add a Code of Conduct.A CODE_OF_CONDUCT.md signals that your project is welcoming. GitHub has a template you can add in one click.

Engineering

98
  • Tests100
    • Test files detected (api/v1/cluster_resource_types_test.go).
    • Go module github.com/neutree-ai/neutree has test files. Run with `go test ./...`.
  • CI/CD100

    Not applicable?

    • CI is configured (.github/workflows/ci.yaml).
    • CI workflow runs tests.
    • CI runs on pull requests, not just on pushes to main.
    • CI workflow runs a lint or format check.
    • Optional: add type checking to CI.Add `tsc --noEmit`, `mypy`, or `cargo check` to catch type errors before they merge.
    • CI reports or uploads test coverage.
  • Linting and formatting100
    • Formatting enforced (.golangci.yaml).
  • Reproducibility85
    • Lockfile present (go.sum). Installs are reproducible.
    • Environment pinned via cluster-image-builder/Dockerfile.
    • No Dependabot config (adding it earns up to +20 pts).Add .github/dependabot.yml with at least one package-ecosystem entry so dependencies are updated automatically.
    • go.mod pins Go version 1.23.0.
  • Issue and PR templates100
    • Issue or PR templates present.
    • Optional: add a SECURITY.md.A SECURITY.md explains how to responsibly disclose vulnerabilities. Worth adding once the project has real users.

Project health

100
  • Dependency manifest100
    • Dependency manifest found (go.mod).
    • go.mod module path is fully qualified (github.com/neutree-ai/neutree).
    • go.mod specifies Go version 1.23.0.
  • Repository metadata100
    • Repository has a description.
    • Primary language detected: Go.
  • Activity100
    • Actively maintained (pushed within the last month).
    • 118 stars.
  • Housekeeping100
    • .gitignore present.

Repository health signals

Activity, community, and responsiveness at scan time

Activity

  • —
    Commits (30d / 90d)
  • 6
    Forks
  • 2
    Releaseslatest 2mo ago

Community

  • —
    Community health
  • —
    authors own >50% of commits
  • 118
    Watchers

Responsiveness

  • <1h
    Median issue response
  • 1h
    Median PR merge time
  • 15
    Open issues
Repository files35 root entries
  • .dewhale
  • .githooks
  • .github
    Good: CI is configured (.github/workflows/ci.yaml).
    Good: Issue or PR templates present.
  • api
    Good: Test files detected (api/v1/cluster_resource_types_test.go).
  • assets
  • cluster-image-builder
    Good: Environment pinned via cluster-image-builder/Dockerfile.
  • cmd
  • contributing
    Good: CONTRIBUTING guide found.
    Issue: CONTRIBUTING guide contents could not be read (−28 pts vs a readable file).Fix: Move the file to the repo root or docs/CONTRIBUTING.md so its setup, style, test, and PR sections can be graded.
  • controllers
  • db
  • deploy
  • docs
  • gateway
  • internal
  • observability
  • pkg
  • python
  • scripts
  • tests
  • .dockerignore
  • .gitignore
    Good: .gitignore present.
  • .golangci.yaml
    Good: Formatting enforced (.golangci.yaml).
  • CLAUDE.md
  • Dockerfile.api
  • Dockerfile.core
  • Dockerfile.db-scripts
  • Dockerfile.runtime
  • go.mod
    Good: Dependency manifest found (go.mod).
  • go.sum
    Good: Lockfile present (go.sum). Installs are reproducible.
  • LICENSE
    Good: Licensed under Apache-2.0.
  • Makefile
  • README.md
    Good: README is present.
    Good: README is well structured with multiple sections.
    Good: README includes screenshots or visuals. Great for first impressions.
    Good: README has code examples.
    Good: README links to a live demo or deployed app.
    Issue: No status badges in the README (−10 pts).Fix: Add CI/build status badges from shields.io or your CI provider to signal project health.
    Good: README documents how to install the project.
    Good: README documents how to run the project.
  • requirements.txt
  • vendir.lock.yml
  • vendir.yml