Public record
Software health reportschema 0.12.0 · metrics 2.10.0 · 2026-07-18 14:10 UTC

weaviate / weaviate-python-client

A python native client for easy interaction with a Weaviate instance.

PythonBSD-3-Clause★ 226 stars⑂ 133 forkssince Sep 2019View on GitHub ↗

weaviate/weaviate-python-client holds a health index of 93 out of 100, placing it in the Exceptional band. It scores highest on Vitality (95/100) and lowest on Security (55/100). It was last updated 4 days ago. 2 contributors account for most of its recent work.

93
overall / 100
Exceptional

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.

93
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 79 is calibrated to 93 on the published index scale (record calibration 2026-08-02).

Ownership

WeaviateOrganization
1,056 followers140 public repossince Mar 2018

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

Package ecosystems

RegistryPackageVersionDownloads / moVersionsLast publish
PyPIweaviate-client4.22.0-29430 days ago

Metrics by category

Vitality

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

95Exceptional · 21% of overall
How it's scored
36/36Push recencylast push 4 days ago
33.9/36Commit cadence49/52 weeks with commits
18/18Commit volume814 commits in the last year
10/10OpenSSF Scorecard: Maintained30 commit(s) and 13 issue activity found in the last 90 days -- score normalized to 10
Inputs used
commits_last_year814
human_commit_share
days_since_last_push4
active_weeks_last_year49
How it's scored
27/27Ships releases100 releases published
36/36Release recencylatest release 30 days ago
27/27Release cadencea release every ~12.5 days
0/10OpenSSF Scorecard: Signed-ReleasesProject has not signed or included provenance with any releases.
Inputs used
releases_count100
latest_release_tagv4.22.0
releases_from_tagsno
days_since_latest_release30
mean_days_between_releases12.5

Community & Adoption

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

67Good · 17% of overall
How it's scored
38.2/60Stars226 stars
17.7/25Forks133 forks
7.8/15Watchers26 watchers
Inputs used
forks133
stars226
watchers26
growth_stateunverified
growth_factor_pct100
growth_unverified_reasonno_history
How it's scored
22.5/22.5README
22.5/22.5Licenserecognized license (BSD-3-Clause)
18/18CONTRIBUTING guide
0/13.5Code of conduct
0/7.2Issue template
0/6.3PR template
Inputs used
has_readmeyes
has_licenseyes
readme_badges
has_contributingyes
has_issue_templateno
has_code_of_conductno
readme_badge_services
has_pull_request_templateno

Sustainability & Governance

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

83Excellent · 23% of overall
How it's scored
25.2/54Bus factor2 contributor(s) cover half of all commits
13.2/22.5Commit distributiontop contributor authored 42% of commits
13.5/13.5Contributor breadth70 contributors
10/10OpenSSF Scorecard: Contributorsproject has 8 contributing companies or organizations
Inputs used
bus_factor2
contributors_sampled70
top_contributor_share0.415
How it's scored
38.3/42Issue resolution91% of issues closed
25.1/30PR acceptance1,352/1,613 decided PRs merged
0/13Newcomer PR acceptanceno first-time contributor's PR decided in 30d
6/15OpenSSF Scorecard: Code-ReviewFound 8/17 approved changesets -- score normalized to 4
Inputs used
merged_prs1,352
open_issues37
closed_issues380
prs_merged_7d
prs_decided_7d
prs_merged_30d
prs_decided_30d
issue_closed_ratio0.911
closed_unmerged_prs261
first_time_authors_30d
first_time_prs_merged_30d
first_time_prs_decided_30d
Excluded from scoring (no data or not applicable): Newcomer PR acceptance. Remaining weights renormalized.
How it's scored
30/30Ownership backingorganization-owned
0/20Verified domainverified-domain status not read for this organization
21.7/25Owner reach1,056 followers of weaviate
25/25Track record140 public repos, account ~8 yr old
Inputs used
followers1,056
owner_typeOrganization
is_verified
owner_loginweaviate
public_repos140
account_age_days3,036
Excluded from scoring (no data or not applicable): Verified domain. Remaining weights renormalized.

Package maintenance

100Exceptional
How it's scored
25/25Published & resolvable1 package(s) on pypi
35/35Publish recencylatest publish 30 days ago
20/20Version history294 published versions
20/20Not deprecatedactive, not deprecated or yanked
Inputs used
packagesweaviate-client
ecosystemspypi
any_deprecatedno
min_days_since_publish30

Engineering Quality

Are baseline engineering and documentation practices in place?

92Excellent · 19% of overall
How it's scored
24/24CI workflows3 workflow(s)
24/24Tests present
16/16Linter config.flake8, ruff.toml
9.6/9.6Pre-commit hooks
0/6.4.editorconfig
20/20OpenSSF Scorecard: CI-Tests17 out of 17 merged PRs checked by a CI test -- score normalized to 10
Inputs used
has_ciyes
has_testsyes
has_editorconfigno
has_linter_configyes
has_precommit_configyes

Documentation

90Excellent
How it's scored
30/30README
25/25Documentation directory
15/15Documentation / homepage sitehttps://weaviate.io/developers/weaviate/client-libraries/python
10/10Repository description
10/10Topics3 topics
0/10Wiki
Inputs used
topicspython, vector-search, weaviate
has_wikino
homepagehttps://weaviate.io/developers/weaviate/client-libraries/python
docs_sitehttps://weaviate.io/developers/weaviate/client-libraries/python
has_readmeyes
has_docs_diryes
has_descriptionyes

Security

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

55Moderate · 16% of overall
How it's scored
7.5/7.5Binary-Artifactsno binaries found in the repo
2.2/7.5Branch-Protectionbranch protection is not maximal on development and all release branches
2.5/2.5CI-Tests17 out of 17 merged PRs checked by a CI test -- score normalized to 10
0/2.5CII-Best-Practicesno effort to earn an OpenSSF best practices badge detected
3/7.5Code-ReviewFound 8/17 approved changesets -- score normalized to 4
2.5/2.5Contributorsproject has 8 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 13 issue activity found in the last 90 days -- score normalized to 10
5/5Packagingpackaging workflow detected
1.5/5Pinned-Dependenciesdependency not pinned by hash detected -- score normalized to 3
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
6/7.5Vulnerabilities2 existing vulnerabilities detected
Inputs used
sourceopenssf_scorecard
checks_evaluated18
scorecard_versionv5.5.0
checks_inconclusive0
scorecard_aggregate5.5

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.

57Moderate · 4% of overall
How it's scored
0/45Agent instructionsno CLAUDE.md / AGENTS.md / editor rules
0/15Machine-readable docs (llms.txt)
0/40Legible commit historyno data
Inputs used
has_llms_txtno
llms_txt_url
legible_history_share
agent_instruction_files
agent_instruction_max_bytes
Excluded from scoring (no data or not applicable): Legible commit history. Remaining weights renormalized.
How it's scored
18/18One-command bootstrapdocs/Makefile
22/22Automated tests
11/11Lint / format config.flake8, ruff.toml
11/11Static type checkingpyrightconfig.json, weaviate/py.typed
10/10Reproducible environmentDockerfile
0/10Demonstrated agent practiceno data
5/8Automated maintenancedependency automation configured, none observed in the sampled commits
3/10OpenSSF Scorecard: Pinned-Dependenciesdependency not pinned by hash detected -- score normalized to 3
Inputs used
has_nixno
has_testsyes
lockfiles
has_dockerfileyes
typed_languageno
bootstrap_filesdocs/Makefile
has_devcontainerno
has_linter_configyes
typecheck_configspyrightconfig.json, weaviate/py.typed
agent_commit_share
toolchain_manifests
dependency_bot_commit_share0
Excluded from scoring (no data or not applicable): Demonstrated agent practice. Remaining weights renormalized.
How it's scored
27/45Type-checkable codePython with type-check config (pyrightconfig.json, weaviate/py.typed)
54.2/55Manageable file sizes7/480 source files over 60KB
Inputs used
primary_languagePython
largest_source_bytes121,902
source_files_sampled480
oversized_source_files7

Key facts

226GitHub stars
70contributors
814commits, last 12 months
4days since last push
100releases
2bus factor
37open issues
PyPIpackage ecosystems

More detail

OpenSSF Scorecard 5.5 / 10
5.5aggregate

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-07-18 14:10 UTC

10Binary-Artifactsno binaries found in the repo
3Branch-Protectionbranch protection is not maximal on development and all release branches
10CI-Tests17 out of 17 merged PRs checked by a CI test -- score normalized to 10
0CII-Best-Practicesno effort to earn an OpenSSF best practices badge detected
4Code-ReviewFound 8/17 approved changesets -- score normalized to 4
10Contributorsproject has 8 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 13 issue activity found in the last 90 days -- score normalized to 10
10Packagingpackaging workflow detected
3Pinned-Dependenciesdependency not pinned by hash detected -- score normalized to 3
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
8Vulnerabilities2 existing vulnerabilities detected
Direct dependencies 7
RegistryPackageVersion constraintManifest
PyPIhttpx>=0.26.0,<0.29.0setup.cfg
PyPIvalidators>=0.34.0,<1.0.0setup.cfg
PyPIauthlib>=1.6.7,<2.0.0setup.cfg
PyPIpydantic>=2.12.0,<3.0.0setup.cfg
PyPIgrpcio>=1.59.5,<1.80.0setup.cfg
PyPIprotobuf>=4.21.6,<7.0.0setup.cfg
PyPIpackaging>=21.0setup.cfg
All dependencies 48

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

RegistryPackageVersionRelation
PyPIauthlib1.6.12direct
PyPIgrpcio1.75.1direct
PyPIhttpx0.26.0direct
PyPIpackaging26.2direct
PyPIprotobufdirect
PyPIpydantic2.12.0direct
PyPIvalidators0.34.0direct
PyPIautodoc-pydantic2.2.0indirect
PyPIbuildindirect
PyPIcoverage7.10.7indirect
PyPIfastapiindirect
PyPIflake8indirect
PyPIflake8-bugbear24.12.12indirect
PyPIflake8-builtins3.0.0indirect
PyPIflake8-comprehensions3.17.0indirect
PyPIflake8-docstrings1.7.0indirect
PyPIflaskindirect
PyPIgrpcio-health-checking1.75.1indirect
PyPIgrpcio-tools1.75.1indirect
PyPIimportlib-metadata8.7.0indirect
PyPIlitestarindirect
PyPInumpyindirect
PyPIpandasindirect
PyPIpolarsindirect
PyPIpre-commitindirect
PyPIpy-spy0.4.1indirect
PyPIpydoclint0.7.3indirect
PyPIpytest9.0.3indirect
PyPIpytest-asyncio1.3.0indirect
PyPIpytest-benchmark5.1.0indirect
PyPIpytest-cov6.2.1indirect
PyPIpytest-httpserver1.1.3indirect
PyPIpytest-profiling1.8.1indirect
PyPIpytest-timeout2.4.0indirect
PyPIpytest-xdist3.7.0indirect
PyPIruff0.14.7indirect
PyPIsetuptoolsindirect
PyPIsetuptools-scmindirect
PyPIsphinxindirect
PyPIsphinx-rtd-theme3.1.0indirect
PyPItomli2.4.0indirect
PyPItwineindirect
PyPItypes-protobuf6.30.2.20250703indirect
PyPItypes-urllib31.26.25.14indirect
PyPItyping-extensions4.14.1indirect
PyPIweaviate-agentsindirect
PyPIwerkzeug3.1.6indirect
PyPIwheelindirect
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.12.0 — full methodology · metrics wiki.

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