Публічний реєстр
Звіт про здоров'я програмного забезпеченнясхема 0.34.0 · метрики 2.10.0 · 2026-09-13 07:03 UTC

Query-farm / vgi-python

Python SDK for the VGI (Vector Gateway Interface) protocol — host DuckDB scalar, table, aggregate, and table-in-out functions in an external worker over Arrow IPC.

PythonВласна ліцензія★ 4 зірки⑂ 0 форківз груд. 2025 р.Переглянути на GitHub ↗
ТипІнструмент командного рядкаБібліотекаяк це визначено

Query-farm/vgi-python має індекс здоров’я 75 зі 100, що відповідає смузі «Добрий». Найвищий показник — Vitality (93/100), найнижчий — Community & Adoption (33/100). Останнє оновлення було 1 день тому. Більшість нещодавньої роботи виконує один учасник.

75
загалом / 100
Добрий

Індекс здоров'я програмного забезпечення

Метрики згруповано у зважені категорії на шкалі 1–100. Загальна оцінка починається як їхнє зважене середнє, відкаліброване за розподілом публічного реєстру, тож діапазони мають перцентильний зміст; коли публічні дані активують Політику юрисдикцій високого ризику, рейтинг коригується й отримує верхню межу 34 («У зоні ризику»).

75
Винятковий93-100Верхній щабель реєстру (≈ топ-5%); відповідає практично всім перевіреним критеріям
Відмінний80-92Сильний за всіма напрямами; незначні прогалини
Добрий65-79Здоровий; прогалини обмежені та керовані
Помірний50-64Прийнятний, але з помітними прогалинами; рекомендовано перевірку
Слабкий35-49Суттєві недоліки в кількох сферах
У зоні ризику20-34Суттєві слабкі місця; впровадження потребує обережності
Критичний1-19Серйозні проблеми (покинутий, єдиний мейнтейнер, без базової гігієни)
ЖиттєздатністьСпільнота тавпровадженняСталість таврядуванняІнженернаякістьБезпекаГотовність доШІ

Профіль оцінок

Кожна вісь — окрема категорія. Форма важить більше, ніж середнє: здоровий об'єкт заповнює всю фігуру, тоді як профіль із піками та провалами означає, що сила в одному вимірі маскує ризик в іншому.

Зважений загальний бал 65 калібровано до 75 за шкалою опублікованого індексу (калібрування реєстру 2026-08-02).

Власність

Query.FarmОрганізація
118 підписників222 публічні репозиторіїз вер. 2024 р.

За цим репозиторієм стоїть організація — спільна, підзвітна опіка, здатна пережити будь-якого окремого мейнтейнера.

Пакетні екосистеми

РеєстрПакетВерсіяЗавантажень / місВерсіїОстання публікаціяТеги
PyPIvgi-python0.32.03 130481 день томуanalyticsapache-arrowarrowdata-engineeringdatabaseduckdbpyarrowrpcsqludfuser-defined-functionsvgi

Метрики за категоріями

Життєздатність

Чи живий проєкт — чи пишеться код і чи виходять релізи?

93Винятковий · 21% загального індексу
Як обчислюється оцінка
36/36Свіжість push — останній push 1 дн. тому
23.5/36Ритм комітів — 34/52 тижнів із комітами
18/18Обсяг комітів — 907 комітів за останній рік
10/10OpenSSF Scorecard: Maintained — 30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10
Використані вхідні дані
commits_last_year907
human_commit_share1
days_since_last_push1
active_weeks_last_year34
Як обчислюється оцінка
27/27Випускає релізи — опубліковано 48 релізів
36/36Свіжість релізів — останній реліз 1 дн. тому
27/27Ритм релізів — реліз кожні ~1,7 дн.
0/10OpenSSF Scorecard: Signed-Releases — немає даних
Використані вхідні дані
releases_count48
latest_release_tagv0.32.0
releases_from_tagsні
days_since_latest_release1
mean_days_between_releases1,7
Виключено з оцінювання (немає даних або не застосовно): OpenSSF Scorecard: Signed-Releases. Залишкові ваги перенормовано.

Спільнота та впровадження

Чи має проєкт користувачів, завантаження, увагу та влаштовані умови для контриб’юторів?

33У зоні ризику · 17% загального індексу
Як обчислюється оцінка
7.7/60Зірки — 4 зірок
0/25Форки — 0 форків
0/15Спостерігачі — 0 спостерігачів
Використані вхідні дані
forks0
stars4
watchers0
growth_stateunverified
growth_factor_pct100
growth_unverified_reasonno_history
Як обчислюється оцінка
22.5/22.5README
16.9/22.5Ліцензія — файл ліцензії наявний, не є визнаною ліцензією
0/18Настанови CONTRIBUTING
0/13.5Кодекс поведінки
0/7.2Шаблон issue
0/6.3Шаблон PR
Використані вхідні дані
has_readmeтак
has_licenseтак
readme_badges4
has_contributingні
has_issue_templateні
has_code_of_conductні
readme_badge_servicesgithub.com, shields.io
has_pull_request_templateні
Як обчислюється оцінка
46.6/80Щомісячні завантаження — 3 130 завантажень/місяць у pypi
0/20Залежні пакети в реєстрі — ця екосистема цього не повідомляє
Використані вхідні дані
packagesvgi-python
dependents—
ecosystemspypi
total_downloads—
monthly_downloads3 130
unverified_packages_excluded—
Виключено з оцінювання (немає даних або не застосовно): Залежні пакети в реєстрі. Залишкові ваги перенормовано.

Сталість та врядування

Чи переживе проєкт своїх людей — бас-фактор, реактивність, хто за ним стоїть і як супроводжуються пакети?

45Слабкий · 23% загального індексу
Як обчислюється оцінка
9/54Бас-фактор — на 1 контриб’ютор(ів) припадає половина всіх комітів
0/22.5Розподіл комітів — головний контриб’ютор — автор 100% комітів
1.4/13.5Широта контриб’юторів — 1 контриб’юторів
3/10OpenSSF Scorecard: Contributors — project has 1 contributing companies or organizations -- score normalized to 3
Використані вхідні дані
bus_factor1
contributors_sampled1
top_contributor_share1
Як обчислюється оцінка
0/42Вирішення issue — закрито 0% issue
18.7/30Прийняття PR — злито 43/69 вирішених PR
0/13Newcomer PR acceptance — за 30 дн. не вирішено жодного PR від новачка
0/15OpenSSF Scorecard: Code-Review — Found 0/30 approved changesets -- score normalized to 0
Використані вхідні дані
merged_prs43
open_issues4
closed_issues0
prs_merged_7d4
prs_decided_7d4
prs_merged_30d4
prs_decided_30d4
issue_closed_ratio0
closed_unmerged_prs26
first_time_authors_30d0
first_time_prs_merged_30d0
first_time_prs_decided_30d0
Виключено з оцінювання (немає даних або не застосовно): Newcomer PR acceptance. Залишкові ваги перенормовано.
Як обчислюється оцінка
30/30Підтримка власника — у власності організації
0/20Верифікований домен
14.9/25Охоплення власника — 118 підписників у Query-farm
16.9/25Послужний список — 222 публічних репозиторіїв, вік облікового запису ~1 р.
Використані вхідні дані
followers118
owner_typeOrganization
is_verifiedні
owner_loginQuery-farm
public_repos222
account_age_days712

Супровід пакетів

100Винятковий
Як обчислюється оцінка
25/25Опубліковано й доступно — 1 пакет(ів) у pypi
35/35Свіжість публікацій — остання публікація 1 дн. тому
20/20Історія версій — 48 опублікованих версій
20/20Не застарілий — активний, не deprecated і не yanked
Використані вхідні дані
packagesvgi-python
ecosystemspypi
any_deprecatedні
min_days_since_publish1

Інженерна якість

Чи наявні базові інженерні практики та документація?

80Відмінний · 19% загального індексу
Як обчислюється оцінка
24/24Процеси CI — 5 процес(ів) CI
24/24Наявні тести
16/16Конфігурація лінтера — pyproject.toml ([tool.ruff])
0/9.6Pre-commit-хуки
0/6.4.editorconfig
10/20OpenSSF Scorecard: CI-Tests — 2 out of 4 merged PRs checked by a CI test -- score normalized to 5
Використані вхідні дані
has_ciтак
has_testsтак
has_editorconfigні
has_linter_configтак
has_precommit_configні

Документація

90Відмінний
Як обчислюється оцінка
30/30README
25/25Каталог документації
15/15Сайт документації / домашня сторінка — https://query.farm
10/10Опис репозиторію
10/10Теми — 16 тем
0/10Wiki
Використані вхідні дані
topicsapache-arrow, arrow, data-engineering, database, duckdb, pyarrow, python, udf, user-defined-functions, vgi, aggregate-functions, arrow-ipc, query-engine, scalar-functions, sdk, table-functions
has_wikiні
homepagehttps://query.farm
docs_sitehttps://query.farm
has_readmeтак
has_docs_dirтак
has_descriptionтак

Безпека

Чи міцні видимі практики безпеки й ланцюга постачання, без непослабленої пов’язаності з юрисдикціями високого ризику?

68Добрий · 16% загального індексу

Стан безпеки

60Помірний
Як обчислюється оцінка
7.5/7.5Binary-Artifacts — no binaries found in the repo
0/7.5Branch-Protection — branch protection not enabled on development/release branches
1.2/2.5CI-Tests — 2 out of 4 merged PRs checked by a CI test -- score normalized to 5
0/2.5CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected
0/7.5Code-Review — Found 0/30 approved changesets -- score normalized to 0
0.8/2.5Contributors — project has 1 contributing companies or organizations -- score normalized to 3
10/10Dangerous-Workflow — no dangerous workflow patterns detected
7.5/7.5Dependency-Update-Tool — update tool detected
0/5Fuzzing — project is not fuzzed
2.2/2.5Ліцензія — license file detected
7.5/7.5Maintained — 30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10
5/5Packaging — packaging workflow detected
0/5Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0
0/5SAST — SAST tool is not run on all commits -- score normalized to 0
4.5/5Security-Policy — security policy file detected
0/7.5Signed-Releases — немає даних
7.5/7.5Token-Permissions — GitHub workflow tokens follow principle of least privilege
5.2/7.5Vulnerabilities — 3 existing vulnerabilities detected
Використані вхідні дані
sourceopenssf_scorecard
checks_evaluated17
scorecard_versionv5.5.0
checks_inconclusive1
scorecard_aggregate6,1
Виключено з оцінювання (немає даних або не застосовно): Signed-Releases. Залишкові ваги перенормовано.
Як обчислюється оцінка
35/35Прямі залежності без відомих сповіщень — жодна пряма залежність не має відомих сповіщень
25/25Непрямі залежності без відомих сповіщень — жодна непряма залежність не має відомих сповіщень
0/40Немає задавнених сповіщень — жодне сповіщення не має дати публікації
Використані вхідні дані
sourceosv
advisories0
affected_packages0
assessed_packages19
unassessed_packages0
affected_by_severitynone
direct_affected_packages0
Виключено з оцінювання (немає даних або не застосовно): Немає задавнених сповіщень. Залишкові ваги перенормовано. Звірено з runtime-замиканням залежностей pypi:vgi-python@0.32.0 — тим, що тягне за собою встановлення опублікованого пакета, — 19 пакетів. Досяжність не аналізується.

Готовність до ШІ

Наскільки репозиторій оснащений для розробки та супроводу за участі ШІ-агентів? Має свідомо малу вагу (4%): агентний інструментарій — реальний сигнал супроводу, але репозиторій без нього все одно може отримати 100/100.

85Відмінний · 4% загального індексу
Як обчислюється оцінка
45/45Інструкції для агентів — CLAUDE.md
15/15Машиночитана документація (llms.txt) — llms.txt опубліковано на сайті проєкту (https://query.farm/llms.txt)
40/40Читабельна історія комітів — намір зазначено у 95 з 100 людських комітів (структурований заголовок або пояснювальний текст)
Використані вхідні дані
has_llms_txtтак
llms_txt_urlhttps://query.farm/llms.txt
legible_history_share0,95
agent_instruction_filesCLAUDE.md
agent_instruction_max_bytes31 968
Як обчислюється оцінка
0/18Розгортання однією командою
22/22Автоматизовані тести
11/11Конфігурація лінтера / форматера — pyproject.toml ([tool.ruff])
11/11Статична перевірка типів — vgi/py.typed
10/10Відтворюване середовище — Dockerfile, lockfile
10/10Підтверджена практика роботи з агентами — 46 з останніх 100 комітів створено агентом або з його зазначенням
5/8Автоматизоване супроводження — автоматизацію залежностей налаштовано, але у вибірці комітів її не видно
0/10OpenSSF Scorecard: Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0
Використані вхідні дані
has_nixні
has_testsтак
lockfilesuv.lock
has_dockerfileтак
typed_languageні
bootstrap_files—
has_devcontainerні
has_linter_configтак
typecheck_configsvgi/py.typed
agent_commit_share0,46
toolchain_manifests—
dependency_bot_commit_share0
Як обчислюється оцінка
27/45Типізований код — Python з конфігурацією перевірки типів (vgi/py.typed)
52.7/55Керовані розміри файлів — 15/364 файлів вихідного коду понад 60 КБ
Використані вхідні дані
primary_languagePython
largest_source_bytes570 322
source_files_sampled364
oversized_source_files15
Як обчислюється оцінка
0/40Схема API (OpenAPI/GraphQL/proto) — не застосовно до цього типу програмного забезпечення
0/20Сервер MCP — не застосовно до цього типу програмного забезпечення
40/40Придатні до запуску приклади — examples
Використані вхідні дані
example_dirsexamples
has_mcp_signalні
api_schema_files—
interfaces_expected_of—
Виключено з оцінювання (немає даних або не застосовно): Схема API (OpenAPI/GraphQL/proto), Сервер MCP. Залишкові ваги перенормовано.

Ключові факти

4зірок GitHub
1контриб'юторів
907комітів за останні 12 місяців
1днів від останнього пушу
48релізів
1бас-фактор
4відкритих issue
PyPIпакетних екосистем

Попередження щодо збору даних

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

Докладніше

OpenSSF Scorecard 6.1 / 10
6.1сукупно

Незалежна, не прив'язана до інструментів оцінка безпеки від відкритого проєкту OpenSSF Scorecard. Кожна перевірка винагороджує практику безпеки, а не інструмент конкретного постачальника. Перевірки, які Scorecard не зміг визначити, позначено н/д і виключено з оцінки безпеки (вони ніколи не зараховуються як нуль).Scorecard v5.5.0 · 2026-09-13 07:03 UTC

10Binary-Artifactsno binaries found in the repo
0Branch-Protectionbranch protection not enabled on development/release branches
5CI-Tests2 out of 4 merged PRs checked by a CI test -- score normalized to 5
0CII-Best-Practicesno effort to earn an OpenSSF best practices badge detected
0Code-ReviewFound 0/30 approved changesets -- score normalized to 0
3Contributorsproject has 1 contributing companies or organizations -- score normalized to 3
10Dangerous-Workflowno dangerous workflow patterns detected
10Dependency-Update-Toolupdate tool detected
0Fuzzingproject is not fuzzed
9Licenselicense file detected
10Maintained30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10
10Packagingpackaging workflow detected
0Pinned-Dependenciesdependency not pinned by hash detected -- score normalized to 0
0SASTSAST tool is not run on all commits -- score normalized to 0
9Security-Policysecurity policy file detected
н/дSigned-Releasesno releases found
10Token-PermissionsGitHub workflow tokens follow principle of least privilege
7Vulnerabilities3 existing vulnerabilities detected
Прямі залежності 6
РеєстрПакетОбмеження версіїМаніфест
PyPIclick—pyproject.toml
PyPIpyarrow—pyproject.toml
PyPItyper>=0.9pyproject.toml
PyPIplatformdirs—pyproject.toml
PyPIvgi-rpc>=0.45.1pyproject.toml
PyPIhttpx2>=2.9.1pyproject.toml
Усі залежності 122

Повний розв'язаний набір залежностей із графа залежностей GitHub: 6 прямих і 116 непрямих (транзитивних) пакетів. Транзитивне замикання є повним, коли в репозиторії закомічено lockfile.

РеєстрПакетВерсіяЗв'язок
PyPIclick8.4.2пряма
PyPIhttpx22.10.0пряма
PyPIplatformdirs4.11.2пряма
PyPIpyarrow25.0.1пряма
PyPItyper0.27.1пряма
PyPIvgi-rpc0.45.1пряма
PyPIaiohappyeyeballs2.7.1непряма
PyPIaiohttp3.14.3непряма
PyPIaiosignal1.4.0непряма
PyPIannotated-doc0.0.5непряма
PyPIannotated-types0.8.0непряма
PyPIanyio4.14.2непряма
PyPIast-serialize0.8.0непряма
PyPIattrs26.1.0непряма
PyPIazure-core1.41.0непряма
PyPIazure-identity1.25.3непряма
PyPIbabel2.18.0непряма
PyPIbackrefs8.0непряма
PyPIblack26.5.1непряма
PyPIcertifi2026.7.22непряма
PyPIcffi2.1.1непряма
PyPIcharset-normalizer3.5.0непряма
PyPIcolorama0.4.6непряма
PyPIcoverage7.15.4непряма
PyPIcryptography50.0.0непряма
PyPIdocstring-parser0.18.0непряма
PyPIduckdb1.5.5непряма
PyPIexecnet2.1.2непряма
PyPIfalcon4.3.1непряма
PyPIfilelock3.32.4непряма
PyPIfrozenlist1.8.0непряма
PyPIghp-import2.1.0непряма
PyPIgranian2.8.1непряма
PyPIgriffelib2.1.0непряма
PyPIh110.16.0непряма
PyPIhatchling—непряма
PyPIhaybarn1.5.5rc1непряма
PyPIhttpcore22.10.0непряма
PyPIhttpx2-jsfetch1.0непряма
PyPIidna3.18непряма
PyPIiniconfig2.3.0непряма
PyPIiroh1.1.0непряма
PyPIjinja23.1.6непряма
PyPIjoserfc1.7.4непряма
PyPIjsonschema4.26.0непряма
PyPIjsonschema-specifications2025.9.1непряма
PyPIlibrt0.15.0непряма
PyPIlxml6.1.1непряма
PyPImarkdown3.10.3непряма
PyPImarkdown-it-py4.2.0непряма
PyPImarkupsafe3.0.3непряма
PyPImdurl0.1.2непряма
PyPImergedeep1.3.4непряма
PyPImkdocs1.6.1непряма
PyPImkdocs-autorefs1.4.4непряма
PyPImkdocs-d2-plugin1.7.0непряма
PyPImkdocs-get-deps0.2.2непряма
PyPImkdocs-material9.7.7непряма
PyPImkdocs-material-extensions1.3.1непряма
PyPImkdocs-section-index0.3.12непряма
PyPImkdocstrings1.0.6непряма
PyPImkdocstrings-python2.0.5непряма
PyPImsal1.37.0непряма
PyPImsal-extensions1.3.1непряма
PyPImsgpack1.2.1непряма
PyPImultidict6.7.1непряма
PyPImypy2.3.0непряма
PyPImypy-extensions1.1.0непряма
PyPInumpy2.5.2непряма
PyPIopentelemetry-api1.44.0непряма
PyPIopentelemetry-sdk1.44.0непряма
PyPIopentelemetry-semantic-conventions0.65b0непряма
PyPIpackaging26.3непряма
PyPIpaginate0.5.7непряма
PyPIpathspec1.1.1непряма
PyPIpluggy1.6.0непряма
PyPIpropcache0.5.2непряма
PyPIproperdocs1.6.7непряма
PyPIpsutil7.2.2непряма
PyPIpyarrow-stubs20.0.0.20260625непряма
PyPIpycparser3.0непряма
PyPIpycryptodome3.23.0непряма
PyPIpydantic2.13.4непряма
PyPIpydantic-core2.46.4непряма
PyPIpygments2.20.0непряма
PyPIpyjwt2.13.0непряма
PyPIpymdown-extensions11.0.1непряма
PyPIpymssql2.3.13непряма
PyPIpynacl1.6.2непряма
PyPIpytest9.1.1непряма
PyPIpytest-cov7.1.0непряма
PyPIpytest-examples0.0.18непряма
PyPIpytest-ruff0.5непряма
PyPIpytest-timeout2.4.0непряма
PyPIpytest-xdist3.8.0непряма
PyPIpython-dateutil2.9.0.post0непряма
PyPIpytokens0.4.1непряма
PyPIpywin32312непряма
PyPIpyyaml6.0.3непряма
PyPIpyyaml-env-tag1.1непряма
PyPIreferencing0.37.0непряма
PyPIrequests2.34.2непряма
PyPIrich15.0.0непряма
PyPIrpds-py2026.6.3непряма
PyPIruff0.16.2непряма
PyPIsentry-sdk2.67.1непряма
PyPIshellingham1.5.4непряма
PyPIsix1.17.0непряма
PyPIsqlglot30.16.0непряма
PyPItenacity9.1.4непряма
PyPItruststore0.10.4непряма
PyPItyping-extensions4.16.0непряма
PyPItyping-inspection0.4.4непряма
PyPItzdata2026.3непряма
PyPIurllib32.7.0непряма
PyPIvgi-fixtures0.8.2непряма
PyPIvgi-python—непряма
PyPIvgi-python0.32.0непряма
PyPIwaitress3.0.2непряма
PyPIwatchdog6.0.0непряма
PyPIyarl1.24.5непряма
PyPIzstandard0.25.0непряма
Сповіщення про залежності 0

Встановлення pypi:vgi-python@0.32.0 тягне 19 пакетів, прямих і транзитивних: 0 мають відомі сповіщення, з них 0 — прямі залежності.

Жодне відоме сповіщення не стосується оцінених залежностей.

Сповіщення означає, що версія, записана в графі залежностей, потрапляє в уражений діапазон. Досяжність не аналізується, а граф містить піниї розробки й тестування — знахідка може стосуватися інструментів, а не поставленого коду.

Звіт у форматі JSON машиночитний

Зворотний зв’язок

Помітили щось хибне у цьому звіті або маєте чим поділитися? Неправильні вимірювання, непомічені інструменти, ідеї, запитання — усе доречно. Кожне повідомлення читається й отримує відповідь.

Повідомлення збережеться під час входу.

Оцінки — це сигнали, а не гарантії. Вони відображають публічно видимі практики на GitHub — це не аудит коду й не гарантія безпеки.

Відсутні дані виключаються, а ваги перенормовуються — нуль за відсутність ніколи не ставиться. Методологія версіонована й відкрита: метрики v2.10.0, схема v0.34.0 — повна методологія · вікі метрик.

Як окремий результат виглядає на тлі всього реєстру: сукупна статистика — PyPI.