feat: fetch GitHub stars and sort software by stars

neural-loop · neural-loop · commit 920d70fd1b38 · 2025-06-29T05:53:48.000-04:00
This commit introduces a script to fetch GitHub star counts and update software entries, allowing sorting by popularity.

- Adds a script to fetch GitHub stars from the API
- Updates archetypes to remove stars and stars_widget_url
- Modifies layouts to dynamically fetch and display star badges, and update sorting.
- Updates the github actions to run the script to update stars on new commits
diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
@@ -63,6 +63,11 @@ jobs:
 
       - name: Generate OG Images
         run: npm run og-images
+        
+      - name: Fetch GitHub Stars
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: npm run fetch-stars
 
       - name: Determine Base URL
         id: base_url
diff --git a/.gitignore b/.gitignore
@@ -20,6 +20,7 @@ yarn.lock
 /tmp/ogImageData.json
 /tmp/output_full.txt
 /tmp/
+.env
 
 # Ignore generated OG images and cache files
 content/**/*-og-*.jpg
diff --git a/archetypes/neuromorphic-software.md b/archetypes/neuromorphic-software.md
@@ -9,9 +9,7 @@ logo: "software-logo.png" # Software logo. Place in this software's folder, or r
 website: "https://official-website.com"
 dependencies: "Key dependencies (e.g., PyTorch, JAX, NumPy, C++17)"
 field_of_application: "e.g., Machine Learning, Neuroscience, Data Processing, Hardware Interface, Robotics"
-source_code: "https://github.com/org/repo"
-stars_widget_url: "https://img.shields.io/github/stars/org/repo.svg?style=social" # Replace org/repo with actual GitHub path
-stars: 0 # This will be auto-updated by a script if implemented, otherwise copy from the badge manually.
+source_code: "https://github.com/org/repo" # This URL is now used to automatically fetch the star count for sorting.
 version_widget_url: "https://img.shields.io/pypi/v/package-name.svg" # Or other relevant badge URL (e.g., GitHub release)
 license: "e.g., MIT, GPL-3.0, AGPL-3.0, Apache-2.0, custom"
 supports_hardware: false # Set to true if it directly supports or deploys to neuromorphic hardware platforms
diff --git a/content/neuromorphic-computing/software/data-tools/aedat/index.md b/content/neuromorphic-computing/software/data-tools/aedat/index.md
@@ -8,7 +8,6 @@ dependencies: Numpy
 field_of_application: Data Processing
 source_code: https://github.com/neuromorphicsystems/aedat
 pypi_id: aedat
-stars: 28
 license: MIT
 supports_hardware: False
 supports_NIR: False
diff --git a/content/neuromorphic-computing/software/data-tools/aestream/index.md b/content/neuromorphic-computing/software/data-tools/aestream/index.md
@@ -8,7 +8,6 @@ dependencies: Numpy, nanobind, pysdl2-dll
 field_of_application: Data Processing
 source_code: https://github.com/aestream/aestream
 pypi_id: aestream
-stars: 49
 license: MIT
 supports_hardware: False
 supports_NIR: False
diff --git a/content/neuromorphic-computing/software/data-tools/expelliarmus/index.md b/content/neuromorphic-computing/software/data-tools/expelliarmus/index.md
@@ -8,7 +8,6 @@ dependencies: Numpy
 field_of_application: Data Processing
 source_code: https://github.com/open-neuromorphic/expelliarmus
 pypi_id: expelliarmus
-stars: 25
 license: GPL-2.0
 supports_hardware: False
 supports_NIR: False
diff --git a/content/neuromorphic-computing/software/data-tools/tonic/index.md b/content/neuromorphic-computing/software/data-tools/tonic/index.md
@@ -8,7 +8,6 @@ dependencies: Numpy
 field_of_application: Data processing
 source_code: https://github.com/neuromorphs/tonic
 pypi_id: tonic
-stars: 167
 license: GPL-3.0
 supports_hardware: False
 supports_NIR: False
diff --git a/content/neuromorphic-computing/software/snn-frameworks/bindsnet/index.md b/content/neuromorphic-computing/software/snn-frameworks/bindsnet/index.md
@@ -8,7 +8,6 @@ dependencies: PyTorch
 field_of_application: Machine Learning
 source_code: https://github.com/bindsnet/bindsnet
 pypi_id: bindsnet
-stars: 1375
 license: AGPL-3.0
 supports_hardware: False
 supports_NIR: False
diff --git a/content/neuromorphic-computing/software/snn-frameworks/brian/index.md b/content/neuromorphic-computing/software/snn-frameworks/brian/index.md
@@ -8,7 +8,6 @@ dependencies:
 field_of_application: Neuroscience
 source_code: https://github.com/brian-team/brian2
 pypi_id: brian2
-stars: 835
 license: custom
 supports_hardware: False
 supports_NIR: False
diff --git a/content/neuromorphic-computing/software/snn-frameworks/carlsim/index.md b/content/neuromorphic-computing/software/snn-frameworks/carlsim/index.md
@@ -2,7 +2,6 @@
 title: CARLsim
 type: neuromorphic-software
 description: GPU-accelerated library for simulating large-scale spiking neural network (SNN) models with high biologically realistic synaptic dynamics.
-stars: 34
 website: https://uci-carl.github.io/CARLsim3/
 field_of_application: Machine Learning, Hardware Interface
 source_code: https://github.com/UCI-CARL/CARLsim6
diff --git a/content/neuromorphic-computing/software/snn-frameworks/genn/index.md b/content/neuromorphic-computing/software/snn-frameworks/genn/index.md
@@ -7,7 +7,6 @@ website: https://genn-team.github.io/
 dependencies: 
 field_of_application: Neuroscience, Machine learning
 source_code: https://github.com/genn-team/genn
-stars: 233
 license: LGPL-2.1
 supports_hardware: False
 supports_NIR: False
diff --git a/content/neuromorphic-computing/software/snn-frameworks/hxtorch/index.md b/content/neuromorphic-computing/software/snn-frameworks/hxtorch/index.md
@@ -7,7 +7,6 @@ dependencies: PyTorch, BrainScaleS-2 OS
 field_of_application: Machine Learning, Neuromorphic Hardware, In-the-loop Training
 source_code: https://github.com/electronicvisions/hxtorch
 version_badge_url_override: "https://img.shields.io/github/v/tag/electronicvisions/releases-ebrains"
-stars: 9
 license: LGPL-2.0-or-later
 supports_hardware: True
 supports_NIR: True
diff --git a/content/neuromorphic-computing/software/snn-frameworks/jaxsnn/index.md b/content/neuromorphic-computing/software/snn-frameworks/jaxsnn/index.md
@@ -7,7 +7,6 @@ website: https://electronicvisions.github.io/documentation-brainscales2/latest/
 dependencies: JAX, BrainScaleS-2 OS
 field_of_application: Machine Learning, Neuromorphic Hardware, In-the-loop Training, Event-based Training
 source_code: https://github.com/electronicvisions/jaxsnn
-stars: 20
 license: LGPL-2.0-or-later
 supports_hardware: True
 supports_NIR: True
diff --git a/content/neuromorphic-computing/software/snn-frameworks/lava/index.md b/content/neuromorphic-computing/software/snn-frameworks/lava/index.md
@@ -8,7 +8,6 @@ dependencies:
 field_of_application: Neuro-inspired Applications
 source_code: https://github.com/lava-nc/lava
 pypi_id: lava-nc
-stars: 462
 license: custom
 supports_hardware: True
 supports_NIR: True
diff --git a/content/neuromorphic-computing/software/snn-frameworks/ml_genn/index.md b/content/neuromorphic-computing/software/snn-frameworks/ml_genn/index.md
@@ -7,7 +7,6 @@ website: https://ml-genn.readthedocs.io/en/latest/
 dependencies: GeNN
 field_of_application: Machine learning
 source_code: https://github.com/genn-team/ml_genn
-stars: 24
 license: LGPL-2.1
 supports_hardware: False
 supports_NIR: False
diff --git a/content/neuromorphic-computing/software/snn-frameworks/nengo/index.md b/content/neuromorphic-computing/software/snn-frameworks/nengo/index.md
@@ -8,7 +8,6 @@ dependencies:
 field_of_application: Machine Learning, Neuroscience
 source_code: https://github.com/nengo/nengo
 pypi_id: nengo
-stars: 781
 license: custom
 supports_hardware: True
 supports_NIR: True
diff --git a/content/neuromorphic-computing/software/snn-frameworks/nest/index.md b/content/neuromorphic-computing/software/snn-frameworks/nest/index.md
@@ -7,7 +7,6 @@ website: https://www.nest-simulator.org/
 dependencies: 
 field_of_application: Neuroscience
 source_code: https://github.com/nest/nest-simulator
-stars: 502
 license: GPL-2.0
 supports_hardware: False
 supports_NIR: False
diff --git a/content/neuromorphic-computing/software/snn-frameworks/norse/index.md b/content/neuromorphic-computing/software/snn-frameworks/norse/index.md
@@ -8,7 +8,6 @@ dependencies: PyTorch
 field_of_application: Bio-inspired Neural Networks
 source_code: https://github.com/norse/norse
 pypi_id: norse
-stars: 578
 license: LGPL-3.0
 supports_hardware: False
 supports_NIR: True
diff --git a/content/neuromorphic-computing/software/snn-frameworks/pynn-brainscales2/index.md b/content/neuromorphic-computing/software/snn-frameworks/pynn-brainscales2/index.md
@@ -7,7 +7,6 @@ dependencies: PyNN, BrainScaleS-2 OS
 field_of_application: Neuromorphic Hardware, Computational Neuroscience, Spiking Neural Networks, Local Plasticity
 source_code: https://github.com/electronicvisions/pynn-brainscales
 version_badge_url_override: "https://img.shields.io/github/v/tag/electronicvisions/releases-ebrains"
-stars: 6
 license: LGPL-2.0-or-later
 supports_hardware: True
 supports_NIR: False
@@ -30,4 +29,4 @@ Due to the real-time nature of the emulation, experiment protocol definition and
 
 Usage of the embedded processors for implementing plasticity rules is integrated such that users can define plasticity rules acting on PyNN network entities and having access to the to be executed code for the processors.
 
-Observables recorded from the hardware are made available using the standard data formats used in PyNN after execution on the hardware.
+Observables recorded from the hardware are made available using the standard data formats used in PyNN after execution on the hardware.
diff --git a/content/neuromorphic-computing/software/snn-frameworks/rockpool/index.md b/content/neuromorphic-computing/software/snn-frameworks/rockpool/index.md
@@ -8,13 +8,13 @@ dependencies: PyTorch, Jax
 field_of_application: Machine Learning
 source_code: https://gitlab.com/synsense/rockpool
 pypi_id: rockpool
-stars: 37
 license: AGPL-3.0
 supports_hardware: True
 supports_NIR: True
 language: Python
 maintainer: Dylan Muir
 draft: false
+stars: 10
 ---
 
 
diff --git a/content/neuromorphic-computing/software/snn-frameworks/sinabs/index.md b/content/neuromorphic-computing/software/snn-frameworks/sinabs/index.md
@@ -8,7 +8,6 @@ dependencies: PyTorch
 field_of_application: Vision Models
 source_code: https://github.com/synsense/sinabs
 pypi_id: sinabs
-stars: 54
 license: AGPL-3.0
 supports_hardware: True
 supports_NIR: True
diff --git a/content/neuromorphic-computing/software/snn-frameworks/snntorch/index.md b/content/neuromorphic-computing/software/snn-frameworks/snntorch/index.md
@@ -8,7 +8,6 @@ dependencies: PyTorch
 field_of_application: Machine Learning
 source_code: https://github.com/jeshraghian/snntorch
 pypi_id: snntorch
-stars: 914
 license: MIT
 supports_hardware: False
 supports_NIR: True
diff --git a/content/neuromorphic-computing/software/snn-frameworks/spikingjelly/index.md b/content/neuromorphic-computing/software/snn-frameworks/spikingjelly/index.md
@@ -8,7 +8,6 @@ dependencies: PyTorch
 field_of_application: Machine Learning
 source_code: https://github.com/fangwei123456/spikingjelly
 pypi_id: spikingjelly
-stars: 998
 license: unknown
 supports_hardware: False
 supports_NIR: False
diff --git a/content/neuromorphic-computing/software/snn-frameworks/spyx/index.md b/content/neuromorphic-computing/software/snn-frameworks/spyx/index.md
@@ -8,7 +8,6 @@ dependencies: JAX, Haiku
 field_of_application: Machine Learning
 source_code: https://github.com/kmheckel/spyx
 pypi_id: spyx
-stars: 30
 license: MIT
 supports_hardware: False
 supports_NIR: True
diff --git a/layouts/partials/components/software-list.html b/layouts/partials/components/software-list.html
@@ -5,10 +5,36 @@
     {{ $isMainSoftwarePage := eq . $mainSoftwarePage }}
 
     {{ $allSoftwarePages := where site.RegularPages "Params.type" "neuromorphic-software" }}
-    {{ $sortedSoftwarePages := sort $allSoftwarePages "Params.stars" "desc" }}
+
+    {{/* Augment pages with star count for sorting */}}
+    {{ $pagesWithStars := slice }}
+    {{ range $allSoftwarePages }}
+    {{ $is_github := false }}
+    {{ $repo_id := "" }}
+    {{ with .Params.source_code }}
+    {{ if in . "github.com" }}
+    {{ $is_github = true }}
+    {{ $repo_id = replace . "https://github.com/" "" }}
+    {{ $repo_id = replace $repo_id ".git" "" }}
+    {{ end }}
+    {{ end }}
+
+    {{ $stars := 0 }}
+    {{ if isset .Params "stars" }}
+    {{ $stars = .Params.stars }}
+    {{ else if and $is_github (ne $repo_id "") site.Data.github_stars }}
+    {{ with index site.Data.github_stars $repo_id }}
+    {{ $stars = . }}
+    {{ end }}
+    {{ end }}
+
+    {{ $pagesWithStars = $pagesWithStars | append (dict "Page" . "Stars" $stars) }}
+    {{ end }}
+
+    {{ $sortedSoftwarePages := sort $pagesWithStars "Stars" "desc" }}
 
     {{ range $sortedSoftwarePages }}
-    {{ $page := . }}
+    {{ $page := .Page }}
 
     {{ $displayPage := false }}
     {{ if $isMainSoftwarePage }}
@@ -23,32 +49,45 @@
     <li class="mb-6 content-panel p-6 shadow-lg rounded-lg">
       <div class="flex flex-col sm:flex-row items-start sm:items-center justify-between gap-2 mb-3">
         <h3 class="text-xl font-bold">
-          <a href="{{ .Permalink }}" class="text-dark dark:text-darkmode-dark hover:text-primary dark:hover:text-darkmode-primary">{{ .Title }}</a>
+          <a href="{{ $page.Permalink }}" class="text-dark dark:text-darkmode-dark hover:text-primary dark:hover:text-darkmode-primary">{{ $page.Title }}</a>
         </h3>
         <div class="flex items-center space-x-2 flex-shrink-0">
-          {{ $repo_id := "" }}
-          {{ with .Params.source_code }}{{ $repo_id = replace . "https://github.com/" "" }}{{ end }}
+          {{ $repo_path := "" }}
+          {{ $is_github := false }}
+          {{ $is_gitlab := false }}
+          {{ with $page.Params.source_code }}
+          {{ if in . "github.com" }}
+          {{ $is_github = true }}
+          {{ $repo_path = replace . "https://github.com/" "" }}
+          {{ else if in . "gitlab.com" }}
+          {{ $is_gitlab = true }}
+          {{ $repo_path = replace . "https://gitlab.com/" "" }}
+          {{ end }}
+          {{ $repo_path = replace $repo_path ".git" "" }}
+          {{ end }}
 
-          {{ if .Params.version_badge_url_override }}
-            <img class="h-5" src="{{ .Params.version_badge_url_override }}" alt="Version Badge">
-          {{ else if .Params.pypi_id }}
-            <img class="h-5" src="https://img.shields.io/pypi/v/{{ .Params.pypi_id }}.svg" alt="PyPI Version">
-          {{ else if $repo_id }}
-            <img class="h-5" src="https://img.shields.io/github/v/release/{{ $repo_id }}" alt="GitHub Release">
+          {{ if $page.Params.version_badge_url_override }}
+          <img class="h-5" src="{{ $page.Params.version_badge_url_override }}" alt="Version Badge">
+          {{ else if $page.Params.pypi_id }}
+          <img class="h-5" src="https://img.shields.io/pypi/v/{{ $page.Params.pypi_id }}.svg" alt="PyPI Version">
+          {{ else if $is_github }}
+          <img class="h-5" src="https://img.shields.io/github/v/release/{{ $repo_path }}" alt="GitHub Release">
           {{ end }}
 
-          {{ if $repo_id }}
-            <img class="h-5" src="https://img.shields.io/github/stars/{{ $repo_id }}.svg?style=social" alt="GitHub Stars">
+          {{ if $is_github }}
+          <img class="h-5" src="https://img.shields.io/github/stars/{{ $repo_path }}.svg?style=social" alt="GitHub Stars">
+          {{ else if $is_gitlab }}
+          <img class="h-5" src="https://img.shields.io/gitlab/stars/{{ $repo_path }}.svg?style=social" alt="GitLab Stars">
           {{ end }}
         </div>
       </div>
 
-      <p class="mb-4 text-text dark:text-darkmode-text">{{ .Params.description }}</p>
+      <p class="mb-4 text-text dark:text-darkmode-text">{{ $page.Params.description }}</p>
 
       <div class="border-t border-border dark:border-darkmode-border pt-4 flex flex-col sm:flex-row items-center justify-between gap-4">
 
         <div class="flex items-center gap-3">
-          {{ with .Params.maintainer }}
+          {{ with $page.Params.maintainer }}
           {{ $maintainerList := . }}
           {{ if not (reflect.IsSlice .) }}{{ $maintainerList = slice . }}{{ end }} {{/* Unify to a slice */}}
 
@@ -92,10 +131,10 @@ <h3 class="text-xl font-bold">
 
         <div class="flex items-center gap-4">
           <div class="flex flex-wrap gap-2">
-            {{ if .Params.supports_NIR }}<span class="support-badge">NIR Support</span>{{ end }}
-            {{ if .Params.supports_hardware }}<span class="support-badge">Hardware Support</span>{{ end }}
+            {{ if $page.Params.supports_NIR }}<span class="support-badge">NIR Support</span>{{ end }}
+            {{ if $page.Params.supports_hardware }}<span class="support-badge">Hardware Support</span>{{ end }}
           </div>
-          <a href="{{ .Permalink }}" class="btn btn-new-outline btn-sm !py-2 !px-4 flex-shrink-0">View Details</a>
+          <a href="{{ $page.Permalink }}" class="btn btn-new-outline btn-sm !py-2 !px-4 flex-shrink-0">View Details</a>
         </div>
       </div>
     </li>
diff --git a/layouts/partials/software/at-a-glance.html b/layouts/partials/software/at-a-glance.html
@@ -24,19 +24,32 @@ <h2 class="text-2xl font-bold text-center mb-4">{{ $page.Title }}</h2>
   </div>
 
   <div class="flex justify-center items-center space-x-2 mb-4">
-    {{ $repo_id := "" }}
-    {{ with .source_code }}{{ $repo_id = replace . "https://github.com/" "" }}{{ end }}
+    {{ $repo_path := "" }}
+    {{ $is_github := false }}
+    {{ $is_gitlab := false }}
+    {{ with .source_code }}
+    {{ if in . "github.com" }}
+    {{ $is_github = true }}
+    {{ $repo_path = replace . "https://github.com/" "" }}
+    {{ else if in . "gitlab.com" }}
+    {{ $is_gitlab = true }}
+    {{ $repo_path = replace . "https://gitlab.com/" "" }}
+    {{ end }}
+    {{ $repo_path = replace $repo_path ".git" "" }}
+    {{ end }}
 
     {{ if .version_badge_url_override }}
-      <img src="{{ .version_badge_url_override }}" alt="Version Badge" class="inline-block h-5">
+    <img src="{{ .version_badge_url_override }}" alt="Version Badge" class="inline-block h-5">
     {{ else if .pypi_id }}
-      <img src="https://img.shields.io/pypi/v/{{ .pypi_id }}.svg" alt="PyPI Version" class="inline-block h-5">
-    {{ else if $repo_id }}
-      <img src="https://img.shields.io/github/v/release/{{ $repo_id }}" alt="GitHub Release" class="inline-block h-5">
+    <img src="https://img.shields.io/pypi/v/{{ .pypi_id }}.svg" alt="PyPI Version" class="inline-block h-5">
+    {{ else if $is_github }}
+    <img src="https://img.shields.io/github/v/release/{{ $repo_path }}" alt="GitHub Release" class="inline-block h-5">
     {{ end }}
-    
-    {{ if $repo_id }}
-      <img src="https://img.shields.io/github/stars/{{ $repo_id }}.svg?style=social" alt="GitHub Stars" class="inline-block h-5">
+
+    {{ if $is_github }}
+    <img src="https://img.shields.io/github/stars/{{ $repo_path }}.svg?style=social" alt="GitHub Stars" class="inline-block h-5">
+    {{ else if $is_gitlab }}
+    <img src="https://img.shields.io/gitlab/stars/{{ $repo_path }}.svg?style=social" alt="GitLab Stars">
     {{ end }}
   </div>
 
@@ -99,11 +112,11 @@ <h2 class="text-2xl font-bold text-center mb-4">{{ $page.Title }}</h2>
         <dt class="font-semibold shrink-0 pr-2">License:</dt>
         <dd class="text-right">{{ .license | default "N/A" }}</dd>
       </div>
-       {{ with .pypi_id }}
+      {{ with .pypi_id }}
       <div class="flex justify-between items-start">
         <dt class="font-semibold shrink-0 pr-2">PyPI Package:</dt>
         <dd class="text-right">
-            <a href="https://pypi.org/project/{{ . }}" target="_blank" rel="noopener" class="text-primary dark:text-darkmode-primary hover:underline">{{ . }}</a>
+          <a href="https://pypi.org/project/{{ . }}" target="_blank" rel="noopener" class="text-primary dark:text-darkmode-primary hover:underline">{{ . }}</a>
         </dd>
       </div>
       {{ end }}
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
diff --git a/scripts/fetchGithubStars.js b/scripts/fetchGithubStars.js
