Звіт про здоров'я програмного забезпеченнясхема 0.16.0 · метрики 2.10.0 · 2026-07-21 02:10 UTC

ashvardanian / NumKong

SIMD-accelerated distances, dot products, matrix ops, geospatial & geometric kernels for 16 numeric types — from 6-bit floats to 64-bit complex — across x86, Arm, RISC-V, and WASM, with bindings for Python, Rust, C, C++, Swift, JS, and Go 📐

C · C++Apache-2.0★ 1 851 зірка⑂ 125 форківз бер. 2023 р.Переглянути на GitHub ↗

ТипБібліотекаяк це визначено

#arm-neon #assembly #metrics #simd #information-retrieval #numpy #scipy #vector-search #blas #matrix-multiplication #rust #tensor #cpp #golang #javascript #swift

ashvardanian/NumKong має індекс здоров’я 84 зі 100, що відповідає смузі «Відмінний». Найвищий показник — Vitality (86/100), найнижчий — AI Readiness (36/100). Останнє оновлення — сьогодні. Більшість нещодавньої роботи виконує один учасник.

загалом / 100

Відмінний

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

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

Винятковий93-100Верхній щабель реєстру (≈ топ-5%); відповідає практично всім перевіреним критеріям

Відмінний80-92Сильний за всіма напрямами; незначні прогалини

Добрий65-79Здоровий; прогалини обмежені та керовані

Помірний50-64Прийнятний, але з помітними прогалинами; рекомендовано перевірку

Слабкий35-49Суттєві недоліки в кількох сферах

У зоні ризику20-34Суттєві слабкі місця; впровадження потребує обережності

Критичний1-19Серйозні проблеми (покинутий, єдиний мейнтейнер, без базової гігієни)

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

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

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

Власність

Ash VardanianОсобистий обліковий запис

1 417 підписників61 публічний репозиторійз лип. 2012 р.BDFL @ Unum

Цей репозиторій належить особистому обліковому запису. Проєкт з єдиним власником несе більший ризик безперервності, ніж підтримуваний організацією.

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

Реєстр	Пакет	Версія	Завантажень / міс	Версії	Остання публікація	Теги
Go	github.com/ashvardanian/NumKong	v2.4.0+incompatible	-	32	1007 днів тому	—
crates.io	numkong	7.7.0	33 438	18	58 днів тому	linear-algebra search simd vector external-ffi-bindings hardware-support no-std wasm mathematics
npm	numkong	7.7.0	558	9	58 днів тому	vector distance similarity search ai math avx2 avx512 neon sve arm x86 simd f16

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

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

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

86Відмінний · 21% загального індексу

Активність розробки

83Відмінний

Як обчислюється оцінка

36/36	Свіжість push — останній push 0 дн. тому
19.4/36	Ритм комітів — 28/52 тижнів із комітами
18/18	Обсяг комітів — 1 426 комітів за останній рік
10/10	OpenSSF Scorecard: Maintained — 10 commit(s) and 2 issue activity found in the last 90 days -- score normalized to 10

Використані вхідні дані

commits_last_year	1 426
human_commit_share	—
days_since_last_push	0
active_weeks_last_year	28

Дисципліна релізів

90Відмінний

Як обчислюється оцінка

27/27	Випускає релізи — опубліковано 100 релізів
36/36	Свіжість релізів — останній реліз 58 дн. тому
27/27	Ритм релізів — реліз кожні ~5,7 дн.
0/10	OpenSSF Scorecard: Signed-Releases — Project has not signed or included provenance with any releases.

Використані вхідні дані

releases_count	100
latest_release_tag	v7.7.0
releases_from_tags	ні
days_since_latest_release	58
mean_days_between_releases	5,7

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

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

80Відмінний · 17% загального індексу

Здоров'я спільноти

85Відмінний

Як обчислюється оцінка

22.5/22.5	README
22.5/22.5	Ліцензія — визнана ліцензія (Apache-2.0)
18/18	Настанови CONTRIBUTING
13.5/13.5	Кодекс поведінки
0/7.2	Шаблон issue
0/6.3	Шаблон PR

Використані вхідні дані

has_readme	так
has_license	так
readme_badges	—
has_contributing	так
has_issue_template	ні
has_code_of_conduct	так
readme_badge_services	—
has_pull_request_template	ні

Впровадження в екосистемі (завантаження)

76Добрий

Як обчислюється оцінка

60.4/80	Щомісячні завантаження — 33 996 завантажень/місяць у crates, go, npm
0/20	Залежні пакети в реєстрі — ця екосистема цього не повідомляє

Використані вхідні дані

packages	github.com/ashvardanian/NumKong, numkong, numkong
dependents	—
ecosystems	crates, go, npm
total_downloads	102 874
monthly_downloads	33 996
unverified_packages_excluded	—

Виключено з оцінювання (немає даних або не застосовно): Залежні пакети в реєстрі. Залишкові ваги перенормовано.

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

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

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

Стійкість мейнтейнерів (бас-фактор)

34У зоні ризику

Як обчислюється оцінка

9/54	Бас-фактор — на 1 контриб’ютор(ів) припадає половина всіх комітів
1.4/22.5	Розподіл комітів — головний контриб’ютор — автор 94% комітів
13.5/13.5	Широта контриб’юторів — 45 контриб’юторів
10/10	OpenSSF Scorecard: Contributors — project has 11 contributing companies or organizations

Використані вхідні дані

bus_factor	1
contributors_sampled	45
top_contributor_share	0,936

Реактивність на issue та PR

72Добрий

Як обчислюється оцінка

34.9/42	Вирішення issue — закрито 83% issue
27.9/30	Прийняття PR — злито 187/201 вирішених PR
0/13	Newcomer PR acceptance — за 30 дн. не вирішено жодного PR від новачка
0/15	OpenSSF Scorecard: Code-Review — Found 0/6 approved changesets -- score normalized to 0

Використані вхідні дані

merged_prs	187
open_issues	26
closed_issues	127
prs_merged_7d	—
prs_decided_7d	—
prs_merged_30d	—
prs_decided_30d	—
issue_closed_ratio	0,83
closed_unmerged_prs	14
first_time_authors_30d	—
first_time_prs_merged_30d	—
first_time_prs_decided_30d	—

Виключено з оцінювання (немає даних або не застосовно): Newcomer PR acceptance. Залишкові ваги перенормовано.

Власність та опіка

72Добрий

Як обчислюється оцінка

10/30	Підтримка власника — особистий (користувацький) обліковий запис
0/20	Верифікований домен — не застосовно до користувацьких облікових записів
22.7/25	Охоплення власника — 1 417 підписників у ashvardanian
25/25	Послужний список — 61 публічних репозиторіїв, вік облікового запису ~14 р.

Використані вхідні дані

followers	1 417
owner_type	User
is_verified	—
owner_login	ashvardanian
public_repos	61
account_age_days	5 117

Виключено з оцінювання (немає даних або не застосовно): Верифікований домен. Залишкові ваги перенормовано.

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

100Винятковий

Як обчислюється оцінка

25/25	Опубліковано й доступно — 3 пакет(ів) у crates, go, npm
35/35	Свіжість публікацій — остання публікація 58 дн. тому
20/20	Історія версій — 32 опублікованих версій
20/20	Не застарілий — активний, не deprecated і не yanked

Використані вхідні дані

packages	github.com/ashvardanian/NumKong, numkong, numkong
ecosystems	crates, go, npm
any_deprecated	ні
min_days_since_publish	58

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

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

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

Інженерні практики

74Добрий

Як обчислюється оцінка

24/24	Процеси CI — 14 процес(ів) CI
24/24	Наявні тести
0/16	Конфігурація лінтера
0/9.6	Pre-commit-хуки
6.4/6.4	.editorconfig
20/20	OpenSSF Scorecard: CI-Tests — 3 out of 3 merged PRs checked by a CI test -- score normalized to 10

Використані вхідні дані

has_ci	так
has_tests	так
has_editorconfig	так
has_linter_config	ні
has_precommit_config	ні

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

65Добрий

Як обчислюється оцінка

30/30	README
0/25	Каталог документації
15/15	Сайт документації / домашня сторінка — https://ashvardanian.com/posts/numkong
10/10	Опис репозиторію
10/10	Теми — 16 тем
0/10	Wiki

Використані вхідні дані

topics	arm-neon, assembly, metrics, simd, information-retrieval, numpy, scipy, vector-search, blas, matrix-multiplication, rust, tensor, cpp, golang, javascript, swift
has_wiki	ні
homepage	https://ashvardanian.com/posts/numkong
docs_site	https://ashvardanian.com/posts/numkong
has_readme	так
has_docs_dir	ні
has_description	так

Безпека

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

60Помірний · 16% загального індексу

Стан безпеки

50Помірний

Як обчислюється оцінка

7.5/7.5	Binary-Artifacts — no binaries found in the repo
0/7.5	Branch-Protection — branch protection not enabled on development/release branches
2.5/2.5	CI-Tests — 3 out of 3 merged PRs checked by a CI test -- score normalized to 10
0/2.5	CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected
0/7.5	Code-Review — Found 0/6 approved changesets -- score normalized to 0
2.5/2.5	Contributors — project has 11 contributing companies or organizations
10/10	Dangerous-Workflow — no dangerous workflow patterns detected
7.5/7.5	Dependency-Update-Tool — update tool detected
0/5	Fuzzing — project is not fuzzed
2.5/2.5	Ліцензія — license file detected
7.5/7.5	Maintained — 10 commit(s) and 2 issue activity found in the last 90 days -- score normalized to 10
5/5	Packaging — packaging workflow detected
0/5	Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0
0/5	SAST — SAST tool is not run on all commits -- score normalized to 0
0/5	Security-Policy — security policy file not detected
0/7.5	Signed-Releases — Project has not signed or included provenance with any releases.
0/7.5	Token-Permissions — detected GitHub workflow tokens with excessive permissions
7.5/7.5	Vulnerabilities — 0 existing vulnerabilities detected

Використані вхідні дані

source	openssf_scorecard
checks_evaluated	18
scorecard_version	v5.5.0
checks_inconclusive	0
scorecard_aggregate	5

Сповіщення про залежності

100Винятковий

Як обчислюється оцінка

35/35	Прямі залежності без відомих сповіщень — жодна пряма залежність не має відомих сповіщень
0/25	Непрямі залежності без відомих сповіщень — транзитивний набір не відокремлюється від залежностей розробки й тестування в цьому обсязі
0/40	Немає задавнених сповіщень — жодне сповіщення не має дати публікації

Використані вхідні дані

source	osv
advisories	0
affected_packages	0
assessed_packages	6
unassessed_packages	20
affected_by_severity	none
direct_affected_packages	0

Виключено з оцінювання (немає даних або не застосовно): Непрямі залежності без відомих сповіщень, Немає задавнених сповіщень. Залишкові ваги перенормовано. Звірено 6 резолвлених залежностей із OSV. 20 не вдалося оцінити — немає резолвленої версії, непідтримувана екосистема або поза межами звітованого переліку пакетів. Цей репозиторій не публікує пакета, який резолвить індекс, тож натомість оцінено граф залежностей репозиторію. Цей граф змішує закріплені версії для розробки й тестування зі справді постачаними залежностями, тож оцінюються лише задекларовані runtime-залежності; транзитивні знахідки подаються як контекст і в оцінку не входять. Досяжність не аналізується.

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

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

36Слабкий · 4% загального індексу

Контекст і настанови для агентів

1Критичний

Як обчислюється оцінка

0/45	Інструкції для агентів — немає CLAUDE.md / AGENTS.md / правил редактора
0/15	Машиночитана документація (llms.txt)
0/40	Читабельна історія комітів — немає даних

Використані вхідні дані

has_llms_txt	ні
llms_txt_url	—
legible_history_share	—
agent_instruction_files	—
agent_instruction_max_bytes	—

Виключено з оцінювання (немає даних або не застосовно): Читабельна історія комітів. Залишкові ваги перенормовано.

Цикл верифікації (збірка / тести / перевірка типів)

40Слабкий

Як обчислюється оцінка

0/18	Розгортання однією командою
22/22	Автоматизовані тести
0/11	Конфігурація лінтера / форматера
11/11	Статична перевірка типів — .vscode/pyrightconfig.json, python/numkong/py.typed
0/10	Відтворюване середовище
0/10	Підтверджена практика роботи з агентами — немає даних
0/8	Автоматизоване супроводження — немає даних
0/10	OpenSSF Scorecard: Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0

Використані вхідні дані

has_nix	ні
has_tests	так
lockfiles	—
has_dockerfile	ні
typed_language	так
bootstrap_files	—
has_devcontainer	ні
has_linter_config	ні
typecheck_configs	.vscode/pyrightconfig.json, python/numkong/py.typed
agent_commit_share	—
toolchain_manifests	—
dependency_bot_commit_share	—

Виключено з оцінювання (немає даних або не застосовно): Підтверджена практика роботи з агентами, Автоматизоване супроводження. Залишкові ваги перенормовано.

Читабельність коду для моделей

94Винятковий

Як обчислюється оцінка

45/45	Типізований код — C (статично типізована)
49.3/55	Керовані розміри файлів — 48/462 файлів вихідного коду понад 60 КБ

Використані вхідні дані

primary_language	C
largest_source_bytes	317 645
source_files_sampled	462
oversized_source_files	48

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

1 851зірок GitHub

45контриб'юторів

1 426комітів за останні 12 місяців

0днів від останнього пушу

100релізів

1бас-фактор

26відкритих issue

crates.io, Go, npm, PyPIпакетних екосистем

Докладніше

OpenSSF Scorecard 5.0 / 10

5.0сукупно

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

10	Binary-Artifacts	no binaries found in the repo
0	Branch-Protection	branch protection not enabled on development/release branches
10	CI-Tests	3 out of 3 merged PRs checked by a CI test -- score normalized to 10
0	CII-Best-Practices	no effort to earn an OpenSSF best practices badge detected
0	Code-Review	Found 0/6 approved changesets -- score normalized to 0
10	Contributors	project has 11 contributing companies or organizations
10	Dangerous-Workflow	no dangerous workflow patterns detected
10	Dependency-Update-Tool	update tool detected
0	Fuzzing	project is not fuzzed
10	License	license file detected
10	Maintained	10 commit(s) and 2 issue activity found in the last 90 days -- score normalized to 10
10	Packaging	packaging workflow detected
0	Pinned-Dependencies	dependency not pinned by hash detected -- score normalized to 0
0	SAST	SAST tool is not run on all commits -- score normalized to 0
0	Security-Policy	security policy file not detected
0	Signed-Releases	Project has not signed or included provenance with any releases.
0	Token-Permissions	detected GitHub workflow tokens with excessive permissions
10	Vulnerabilities	0 existing vulnerabilities detected

Прямі залежності 4

Реєстр	Пакет	Обмеження версії	Маніфест
crates.io	fork_union	`2.3`	Cargo.toml
npm	bindings	`^1.5.0`	package.json
npm	node-addon-api	`^8.5.0`	package.json
npm	node-gyp-build	`^4.8.4`	package.json

Усі залежності 26

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

Реєстр	Пакет	Версія	Зв'язок
crates.io	fork_union	`—`	пряма
npm	bindings	`^1.5.0`	пряма
npm	node-addon-api	`^8.5.0`	пряма
npm	node-gyp-build	`^4.8.4`	пряма
crates.io	cc	`—`	непряма
crates.io	half	`—`	непряма
crates.io	rand	`—`	непряма
crates.io	wasmtime	`—`	непряма
crates.io	wasmtime-wasi	`—`	непряма
npm	@numkong/darwin-arm64	`7.7.0`	непряма
npm	@numkong/darwin-x64	`7.7.0`	непряма
npm	@numkong/linux-arm64	`7.7.0`	непряма
npm	@numkong/linux-x64	`7.7.0`	непряма
npm	@numkong/win32-arm64	`7.7.0`	непряма
npm	@numkong/win32-x64	`7.7.0`	непряма
npm	@playwright/test	`^1.58.0`	непряма
npm	@types/bindings	`^1.5.5`	непряма
npm	@types/node	`^24.10.0`	непряма
npm	benchmark	`^2.1.4`	непряма
npm	esbuild	`^0.25.0`	непряма
npm	http-server	`^14.1.1`	непряма
npm	mathjs	`^14.9.0`	непряма
npm	node-gyp	`^11.5.0`	непряма
npm	playwright	`^1.58.0`	непряма
npm	typescript	`^5.9.3`	непряма
npm	usearch	`^2.21.0`	непряма

Сповіщення про залежності 0

Цей репозиторій не публікує пакета, який розпізнає індекс, тож оцінено його власний граф залежностей — 6 пакетів, серед яких є й піниї розробки та тестування, що ніколи не постачаються: 0 мають відомі сповіщення, з них 0 прямі. 20 не вдалося оцінити — немає резолвленої версії, непідтримувана екосистема або поза наведеним переліком пакетів.

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

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

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

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

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

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

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

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

53/60	Зірки — 1 851 зірок
17.4/25	Форки — 125 форків
7.6/15	Спостерігачі — 24 спостерігачів

forks	125
stars	1 851
watchers	24
growth_state	unverified
growth_factor_pct	100
growth_unverified_reason	no_history

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

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

Власність

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

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

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

Докладніше

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

Пов’язані записи