Public record
Software health reportschema 0.34.0 · metrics 2.10.0 · 2026-09-20 08:45 UTC

VILLASframework / node

Open-Source Real-time Multi-protocol Gateway

C++Apache-2.0★ 21 stars⑂ 23 forkssince Dec 2022View on GitHub ↗
KindCommand-line toolLibraryhow this is determined

VILLASframework/node holds a health index of 83 out of 100, placing it in the Excellent band. It scores highest on Engineering Quality (90/100) and lowest on Community & Adoption (48/100). It was last updated 4 days ago. A single contributor accounts for most of its recent work.

83
overall / 100
Excellent

Software health index

Metrics are grouped into weighted categories on one standardized 1–100 scale. Overall starts as their weighted mean, calibrated against the distribution of the public record so bands carry percentile meaning; when public evidence triggers the High-Risk Jurisdiction Policy, the rating is adjusted and receives an At Risk ceiling of 34.

83
Exceptional93-100The record's top tier (≈ top 5%); essentially all checked criteria met
Excellent80-92Strong across the board; minor gaps
Good65-79Healthy; gaps are limited and manageable
Moderate50-64Acceptable with notable gaps; review recommended
Weak35-49Material weaknesses across several areas
At Risk20-34Significant weaknesses; adoption warrants caution
Critical1-19Severe problems (abandoned, single-maintainer, no hygiene)
VitalityCommunity &AdoptionSustainability &GovernanceEngineeringQualitySecurityAI Readiness

Score profile

Each axis is a category. The shape matters more than the average — a healthy subject fills the whole shape, while a spike-and-crater profile means strength in one dimension is masking risk in another.

The weighted overall 70 is calibrated to 83 on the published index scale (record calibration 2026-08-02).

Ownership

VILLASframeworkOrganization · verified domain
21 followers15 public repossince Nov 2017

This repository is backed by an organization — shared, accountable stewardship that can outlive any single maintainer.

Package ecosystems

RegistryPackageVersionDownloads / moVersionsLast publishTags
PyPIvillas-node1.1.017110288 days agosimulationpowersystemreal-timevillas

Metrics by category

Vitality

Is the project alive — is code being written and are releases shipping?

84Excellent · 21% of overall
How it's scored
36/36Push recencylast push 4 days ago
20.8/36Commit cadence30/52 weeks with commits
18/18Commit volume247 commits in the last year
10/10OpenSSF Scorecard: Maintained30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10
Inputs used
commits_last_year247
human_commit_share0.92
days_since_last_push4
active_weeks_last_year30
How it's scored
27/27Ships releases8 releases published
36/36Release recencylatest release 5 days ago
19.8/27Release cadencea release every ~55.6 days
0/10OpenSSF Scorecard: Signed-ReleasesProject has not signed or included provenance with any releases.
Inputs used
releases_count8
latest_release_tagv1.3.2
releases_from_tagsno
days_since_latest_release5
mean_days_between_releases55.6

Community & Adoption

Does the project have users, downloads, attention, and a welcoming setup for contributors?

48Weak · 17% of overall
How it's scored
21.1/60Stars21 stars
11.2/25Forks23 forks
3.9/15Watchers6 watchers
Inputs used
forks23
stars21
watchers6
growth_stateunverified
growth_factor_pct100
growth_unverified_reasonno_history
How it's scored
22.5/22.5README
22.5/22.5Licenserecognized license (Apache-2.0)
18/18CONTRIBUTING guide
0/13.5Code of conduct
0/7.2Issue template
0/6.3PR template
Inputs used
has_readmeyes
has_licenseyes
readme_badges1
has_contributingyes
has_issue_templateno
has_code_of_conductno
readme_badge_servicesgithub.com
has_pull_request_templateno
How it's scored
29.8/80Monthly downloads171 downloads/month across pypi
0/20Registry dependentsnot reported by this ecosystem
Inputs used
packagesvillas-node
dependents
ecosystemspypi
total_downloads
monthly_downloads171
unverified_packages_excluded
Excluded from scoring (no data or not applicable): Registry dependents. Remaining weights renormalized.

Sustainability & Governance

Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep?

72Good · 23% of overall
How it's scored
9/54Bus factor1 contributor(s) cover half of all commits
6.2/22.5Commit distributiontop contributor authored 72% of commits
13.5/13.5Contributor breadth30 contributors
10/10OpenSSF Scorecard: Contributorsproject has 16 contributing companies or organizations
Inputs used
bus_factor1
contributors_sampled30
top_contributor_share0.723
How it's scored
38.3/42Issue resolution91% of issues closed
25.6/30PR acceptance286/335 decided PRs merged
0/13Newcomer PR acceptanceno first-time contributor's PR decided in 30d
12/15OpenSSF Scorecard: Code-ReviewFound 4/5 approved changesets -- score normalized to 8
Inputs used
merged_prs286
open_issues62
closed_issues649
prs_merged_7d2
prs_decided_7d2
prs_merged_30d7
prs_decided_30d7
issue_closed_ratio0.913
closed_unmerged_prs49
first_time_authors_30d0
first_time_prs_merged_30d0
first_time_prs_decided_30d0
Excluded from scoring (no data or not applicable): Newcomer PR acceptance. Remaining weights renormalized.
How it's scored
30/30Ownership backingorganization-owned
20/20Verified domain
9.7/25Owner reach21 followers of VILLASframework
20.8/25Track record15 public repos, account ~8 yr old
Inputs used
followers21
owner_typeOrganization
is_verifiedyes
owner_loginVILLASframework
public_repos15
account_age_days3,225
How it's scored
25/25Published & resolvable1 package(s) on pypi
26/35Publish recencylatest publish 288 days ago
20/20Version history10 published versions
20/20Not deprecatedactive, not deprecated or yanked
Inputs used
packagesvillas-node
ecosystemspypi
any_deprecatedno
min_days_since_publish288

Engineering Quality

Are baseline engineering and documentation practices in place?

90Excellent · 19% of overall
How it's scored
24/24CI workflows14 workflow(s)
24/24Tests present
16/16Linter configpython/pyproject.toml ([tool.black])
9.6/9.6Pre-commit hooks
6.4/6.4.editorconfig
10/20OpenSSF Scorecard: CI-Tests4 out of 8 merged PRs checked by a CI test -- score normalized to 5
Inputs used
has_ciyes
has_testsyes
has_editorconfigyes
has_linter_configyes
has_precommit_configyes

Documentation

90Excellent
How it's scored
30/30README
25/25Documentation directory
15/15Documentation / homepage sitehttps://villas.fein-aachen.org/
10/10Repository description
10/10Topics4 topics
0/10Wiki
Inputs used
topicssimulation, villas, co-simulation, real-time
has_wikino
homepagehttps://villas.fein-aachen.org/
docs_sitehttps://villas.fein-aachen.org/
has_readmeyes
has_docs_diryes
has_descriptionyes

Security

Are visible security and supply-chain practices strong, without unresolved high-risk jurisdiction exposure?

53Moderate · 16% of overall
How it's scored
7.5/7.5Binary-Artifactsno binaries found in the repo
3.8/7.5Branch-Protectionbranch protection is not maximal on development and all release branches
1.2/2.5CI-Tests4 out of 8 merged PRs checked by a CI test -- score normalized to 5
0/2.5CII-Best-Practicesno effort to earn an OpenSSF best practices badge detected
6/7.5Code-ReviewFound 4/5 approved changesets -- score normalized to 8
2.5/2.5Contributorsproject has 16 contributing companies or organizations
10/10Dangerous-Workflowno dangerous workflow patterns detected
7.5/7.5Dependency-Update-Toolupdate tool detected
0/5Fuzzingproject is not fuzzed
2.5/2.5Licenselicense file detected
7.5/7.5Maintained30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10
0/5Packagingno data
0/5Pinned-Dependenciesdependency not pinned by hash detected -- score normalized to 0
0/5SASTSAST tool is not run on all commits -- score normalized to 0
0/5Security-Policysecurity policy file not detected
0/7.5Signed-ReleasesProject has not signed or included provenance with any releases.
0/7.5Token-Permissionsdetected GitHub workflow tokens with excessive permissions
0/7.5Vulnerabilities70 existing vulnerabilities detected
Inputs used
sourceopenssf_scorecard
checks_evaluated17
scorecard_versionv5.5.0
checks_inconclusive1
scorecard_aggregate4.8
Excluded from scoring (no data or not applicable): Packaging. Remaining weights renormalized.
How it's scored
14/35Direct dependencies free of known advisories1 affected: protobuf 6.32.1 (high 7.5)
25/25Indirect dependencies free of known advisoriesno indirect dependency carries a known advisory
33.7/40No advisories left outstanding1 advisory-carrying package(s) unaddressed past 90 days; oldest published 239 days ago
Inputs used
sourceosv
advisories2
affected_packages1
assessed_packages3
unassessed_packages0
affected_by_severityhigh 1
direct_affected_packages1
Matched the pypi:villas-node@1.1.0 runtime dependency closure — what installing the published package pulls in — 3 packages. Reachability is not analyzed.

AI Readiness

How well is the repo equipped to be developed and maintained with AI coding agents? Carries a deliberately small weight (4%): agent tooling is a real maintenance signal, but a repository with none can still reach 100/100.

64Moderate · 4% of overall
How it's scored
0/45Agent instructionsno CLAUDE.md / AGENTS.md / editor rules
0/15Machine-readable docs (llms.txt)
40/40Legible commit history90 of 92 human commits state their intent (structured subject or explanatory body)
Inputs used
has_llms_txtno
llms_txt_url
legible_history_share0.978
agent_instruction_files
agent_instruction_max_bytes
How it's scored
0/18One-command bootstrap
22/22Automated tests
11/11Lint / format configpython/pyproject.toml ([tool.black])
11/11Static type checkingC++ (statically typed)
10/10Reproducible environmentdevcontainer, Dockerfile, Nix, lockfile
0/10Demonstrated agent practiceno agent-authored commits among the last 100
0/8Automated maintenanceno automated dependency updates observed
0/10OpenSSF Scorecard: Pinned-Dependenciesdependency not pinned by hash detected -- score normalized to 0
Inputs used
has_nixyes
has_testsyes
lockfilespackage-lock.json
has_dockerfileyes
typed_languageyes
bootstrap_files
has_devcontaineryes
has_linter_configyes
typecheck_configs
agent_commit_share0
toolchain_manifests
dependency_bot_commit_share0
How it's scored
45/45Type-checkable codeC++ (statically typed)
54.7/55Manageable file sizes3/492 source files over 60KB
Inputs used
primary_languageC++
largest_source_bytes618,155
source_files_sampled492
oversized_source_files3
How it's scored
40/40API schema (OpenAPI/GraphQL/proto)doc/openapi/openapi.yaml, lib/formats/villas.proto
0/20MCP servernot applicable to this kind of software
40/40Runnable examplesexamples, notebooks
Inputs used
example_dirsexamples, notebooks
has_mcp_signalno
api_schema_filesdoc/openapi/openapi.yaml, lib/formats/villas.proto
interfaces_expected_of
Excluded from scoring (no data or not applicable): MCP server. Remaining weights renormalized.

Key facts

21GitHub stars
30contributors
247commits, last 12 months
4days since last push
8releases
1bus factor
62open issues
npm, PyPIpackage ecosystems

Data collection warnings

  • Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token

More detail

Star and fork history 0 ★ / 23 ⇿
0Stars
23Forks
3Releases

When each star and fork was added, collected from GitHub and bucketed by day. Cumulative growth sits directly above the daily additions it is made of, so the two read against each other: steady organic accretion looks nothing like an abrupt, short-lived burst. Where that difference is measurable, it is reported as growth authenticity.

048121620242312023-052025-012026-09
Major 0Minor 2Patch 1

Each point covers 4 days.

OpenSSF Scorecard 4.8 / 10
4.8aggregate

Independent, tool-agnostic security assessment from the open-source OpenSSF Scorecard. Each check rewards a security practice, not a specific vendor's tool. Checks Scorecard could not determine are marked n/a and excluded from the security score (never counted as zero).Scorecard v5.5.0 · 2026-09-20 08:44 UTC

10Binary-Artifactsno binaries found in the repo
5Branch-Protectionbranch protection is not maximal on development and all release branches
5CI-Tests4 out of 8 merged PRs checked by a CI test -- score normalized to 5
0CII-Best-Practicesno effort to earn an OpenSSF best practices badge detected
8Code-ReviewFound 4/5 approved changesets -- score normalized to 8
10Contributorsproject has 16 contributing companies or organizations
10Dangerous-Workflowno dangerous workflow patterns detected
10Dependency-Update-Toolupdate tool detected
0Fuzzingproject is not fuzzed
10Licenselicense file detected
10Maintained30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10
n/aPackagingpackaging workflow not detected
0Pinned-Dependenciesdependency not pinned by hash detected -- score normalized to 0
0SASTSAST tool is not run on all commits -- score normalized to 0
0Security-Policysecurity policy file not detected
0Signed-ReleasesProject has not signed or included provenance with any releases.
0Token-Permissionsdetected GitHub workflow tokens with excessive permissions
0Vulnerabilities70 existing vulnerabilities detected
Direct dependencies 3
RegistryPackageVersion constraintManifest
PyPIlinuxfd==1.5python/pyproject.toml
PyPIprotobuf==6.32.1python/pyproject.toml
PyPIlibconf==2.0.1python/pyproject.toml
All dependencies 210

Full resolved dependency set from the GitHub dependency graph: 3 direct and 207 indirect (transitive) packages. The transitive closure is complete when the repository commits a lockfile.

RegistryPackageVersionRelation
PyPIlibconf2.0.1direct
PyPIlinuxfd1.5direct
PyPIprotobuf6.32.1direct
npm@babel/code-frame7.29.0indirect
npm@babel/helper-validator-identifier7.28.5indirect
npm@babel/runtime7.29.2indirect
npm@emotion/is-prop-valid1.4.0indirect
npm@emotion/memoize0.9.0indirect
npm@emotion/unitless0.10.0indirect
npm@exodus/schemasafe1.3.0indirect
npm@faker-js/faker7.6.0indirect
npm@humanwhocodes/momoa2.0.4indirect
npm@noble/hashes1.8.0indirect
npm@opentelemetry/api1.9.0indirect
npm@opentelemetry/api-logs0.202.0indirect
npm@opentelemetry/context-async-hooks2.0.1indirect
npm@opentelemetry/core2.0.1indirect
npm@opentelemetry/exporter-trace-otlp-http0.202.0indirect
npm@opentelemetry/otlp-exporter-base0.202.0indirect
npm@opentelemetry/otlp-transformer0.202.0indirect
npm@opentelemetry/resources2.0.1indirect
npm@opentelemetry/sdk-logs0.202.0indirect
npm@opentelemetry/sdk-metrics2.0.1indirect
npm@opentelemetry/sdk-trace-base2.0.1indirect
npm@opentelemetry/sdk-trace-node2.0.1indirect
npm@opentelemetry/semantic-conventions1.34.0indirect
npm@protobufjs/aspromise1.1.2indirect
npm@protobufjs/base641.1.2indirect
npm@protobufjs/codegen2.0.4indirect
npm@protobufjs/eventemitter1.1.0indirect
npm@protobufjs/fetch1.1.0indirect
npm@protobufjs/float1.0.2indirect
npm@protobufjs/inquire1.1.0indirect
npm@protobufjs/path1.1.2indirect
npm@protobufjs/pool1.1.0indirect
npm@protobufjs/utf81.1.0indirect
npm@redocly/ajv8.11.2indirect
npm@redocly/ajv8.18.0indirect
npm@redocly/cli2.25.1indirect
npm@redocly/cli-otel0.1.2indirect
npm@redocly/config0.22.0indirect
npm@redocly/config0.44.2indirect
npm@redocly/openapi-core1.34.11indirect
npm@redocly/openapi-core2.25.1indirect
npm@redocly/respect-core2.25.1indirect
npm@types/json-schema7.0.15indirect
npm@types/node25.5.0indirect
npm@types/stylis4.2.7indirect
npm@types/trusted-types2.0.7indirect
npmabort-controller3.0.0indirect
npmagent-base7.1.4indirect
npmajv-formats3.0.1indirect
npmansi-regex5.0.1indirect
npmansi-styles4.3.0indirect
npmargparse2.0.1indirect
npmbalanced-match1.0.2indirect
npmbalanced-match4.0.4indirect
npmbetter-ajv-errors1.2.0indirect
npmbrace-expansion2.0.2indirect
npmbrace-expansion5.0.4indirect
npmcall-me-maybe1.0.2indirect
npmcamelize1.0.1indirect
npmchalk4.1.2indirect
npmclassnames2.5.1indirect
npmcliui7.0.4indirect
npmclsx2.1.1indirect
npmcolor-convert2.0.1indirect
npmcolor-name1.1.4indirect
npmcolorette1.4.0indirect
npmcolorette2.0.20indirect
npmcookie0.7.2indirect
npmcore-js3.49.0indirect
npmcss-color-keywords1.0.0indirect
npmcss-to-react-native3.2.0indirect
npmcsstype3.2.3indirect
npmdebug4.4.3indirect
npmdecko1.2.0indirect
npmdompurify3.3.3indirect
npmdotenv16.4.7indirect
npmemoji-regex8.0.0indirect
npmes6-promise3.3.1indirect
npmescalade3.2.0indirect
npmevent-target-shim5.0.1indirect
npmeventemitter35.0.4indirect
npmfast-deep-equal3.1.3indirect
npmfast-safe-stringify2.1.1indirect
npmfast-uri3.1.0indirect
npmfast-xml-builder1.1.4indirect
npmfast-xml-parser5.5.9indirect
npmforeach2.0.6indirect
npmget-caller-file2.0.5indirect
npmglob13.0.6indirect
npmhandlebars4.7.8indirect
npmhas-flag4.0.0indirect
npmhttp2-client1.3.5indirect
npmhttps-proxy-agent7.0.6indirect
npminherits2.0.4indirect
npmis-fullwidth-code-point3.0.0indirect
npmjs-levenshtein1.1.6indirect
npmjs-tokens4.0.0indirect
npmjs-yaml4.1.1indirect
npmjson-pointer0.6.2indirect
npmjson-schema-to-ts2.7.2indirect
npmjson-schema-traverse1.0.0indirect
npmjsonpath-rfc95351.3.0indirect
npmjsonpointer5.0.1indirect
npmleven3.1.0indirect
npmlong5.3.2indirect
npmloose-envify1.4.0indirect
npmlru-cache11.2.7indirect
npmlunr2.3.9indirect
npmmark.js8.11.1indirect
npmmarked4.3.0indirect
npmminimatch10.2.4indirect
npmminimatch5.1.9indirect
npmminimist1.2.8indirect
npmminipass7.1.3indirect
npmmobx6.15.0indirect
npmmobx-react9.2.0indirect
npmmobx-react-lite4.1.1indirect
npmms2.1.3indirect
npmnanoid3.3.11indirect
npmneo-async2.6.2indirect
npmnode-fetch2.7.0indirect
npmnode-fetch-h22.3.0indirect
npmnode-readfiles0.2.0indirect
npmoas-kit-common1.0.8indirect
npmoas-linter3.2.2indirect
npmoas-resolver2.5.6indirect
npmoas-schema-walker1.1.5indirect
npmoas-validator5.0.8indirect
npmobject-assign4.1.1indirect
npmopenapi-sampler1.7.2indirect
npmoutdent0.8.0indirect
npmpath-browserify1.0.1indirect
npmpath-expression-matcher1.2.0indirect
npmpath-scurry2.0.2indirect
npmperfect-scrollbar1.5.6indirect
npmpicocolors1.1.1indirect
npmpicomatch4.0.4indirect
npmpluralize8.0.0indirect
npmpolished4.3.1indirect
npmpostcss8.4.49indirect
npmpostcss-value-parser4.2.0indirect
npmprismjs1.30.0indirect
npmprop-types15.8.1indirect
npmprotobufjs7.5.4indirect
npmqueue-microtask1.2.3indirect
npmrandombytes2.1.0indirect
npmreact19.2.4indirect
npmreact-dom19.2.4indirect
npmreact-is16.13.1indirect
npmreact-tabs6.1.0indirect
npmreadable-stream3.6.2indirect
npmredoc2.5.1indirect
npmreftools1.1.9indirect
npmrequire-directory2.1.1indirect
npmrequire-from-string2.0.2indirect
npmsafe-buffer5.2.1indirect
npmscheduler0.27.0indirect
npmsemver7.7.4indirect
npmset-cookie-parser2.7.2indirect
npmshallowequal1.1.0indirect
npmshould13.2.3indirect
npmshould-equal2.0.0indirect
npmshould-format3.0.3indirect
npmshould-type1.4.0indirect
npmshould-type-adaptors1.1.0indirect
npmshould-util1.0.1indirect
npmsimple-websocket9.1.0indirect
npmslugify1.4.7indirect
npmsource-map0.6.1indirect
npmsource-map-js1.2.1indirect
npmstickyfill1.1.1indirect
npmstring-width4.2.3indirect
npmstring_decoder1.3.0indirect
npmstrip-ansi6.0.1indirect
npmstrnum2.2.2indirect
npmstyled-components6.3.9indirect
npmstylis4.3.6indirect
npmsupports-color7.2.0indirect
npmswagger2openapi7.0.8indirect
npmtr460.0.3indirect
npmts-algebra1.2.2indirect
npmtslib2.8.1indirect
npmuglify-js3.19.3indirect
npmulid2.4.0indirect
npmulid3.0.2indirect
npmundici6.24.0indirect
npmundici-types7.18.2indirect
npmuri-js-replace1.0.1indirect
npmurl-template2.0.8indirect
npmuse-sync-external-store1.6.0indirect
npmutil-deprecate1.0.2indirect
npmwebidl-conversions3.0.1indirect
npmwhatwg-url5.0.0indirect
npmwordwrap1.0.0indirect
npmwrap-ansi7.0.0indirect
npmws7.5.10indirect
npmy18n5.0.8indirect
npmyaml1.10.3indirect
npmyaml-ast-parser0.0.43indirect
npmyargs17.0.1indirect
npmyargs-parser20.2.9indirect
PyPIblack25.11.0indirect
PyPIflake87.3.0indirect
PyPImypy1.19.0indirect
PyPIpytest9.0.1indirect
PyPIsetuptoolsindirect
PyPItypes-protobuf6.32.1.20251105indirect
Dependency advisories 1

Installing pypi:villas-node@1.1.0 pulls in 3 packages, direct and transitive: 1 carry known advisories, of which 1 are direct dependencies.

PackageVersionRelationSeverityAdvisoriesFixed in
protobuf6.32.1directhigh26.33.5

An advisory means the version recorded in the dependency graph falls inside an advisory’s affected range. Reachability is not analysed, and the graph includes development and test pins — a finding may concern tooling rather than shipped software.

Raw JSON report machine-readable

Feedback

Spotted something off in this report, or have thoughts to share? Wrong measurements, missed tooling, ideas, questions — anything is welcome. Every message is read and gets a response.

The message is kept through sign-in.

Scores are signals, not warranties. They reflect publicly visible practices on GitHub — not a code audit, and not a security guarantee.

Missing data is excluded and weights renormalized, never scored as zero. Methodology is versioned and open: metrics v2.10.0, schema v0.34.0 — full methodology · metrics wiki.

How one result sits in the wider record: aggregate statisticsPyPI.