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

monocle2ai / monocle

Monocle is a framework for tracing GenAI app code. This repo contains implementation of Monocle for GenAI apps written in Python.

PythonApache-2.0★ 337 зірок⑂ 58 форківз черв. 2024 р.Переглянути на GitHub ↗
ТипБібліотекаІнструмент командного рядкаMCP-серверПлагіняк це визначено

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

94
загалом / 100
Винятковий

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

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

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

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

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

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

Власність

Monocle AIОрганізація
48 підписників7 публічних репозиторіївз черв. 2024 р.

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

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

РеєстрПакетВерсіяЗавантажень / місВерсіїОстання публікація
PyPImonocle_mcp0.8.14615240 днів тому
PyPImonocle_apptrace0.8.1448 766520 днів тому
PyPImonocle_test_tools0.8.142 040280 днів тому

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

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

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

100Винятковий · 21% загального індексу
Як обчислюється оцінка
36/36Свіжість pushостанній push 0 дн. тому
36/36Ритм комітів52/52 тижнів із комітами
18/18Обсяг комітів392 комітів за останній рік
10/10OpenSSF Scorecard: Maintained30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10
Використані вхідні дані
commits_last_year392
human_commit_share0,94
days_since_last_push0
active_weeks_last_year52
Як обчислюється оцінка
27/27Випускає релізиопубліковано 52 релізів
36/36Свіжість релізівостанній реліз 0 дн. тому
27/27Ритм релізівреліз кожні ~8,9 дн.
0/10OpenSSF Scorecard: Signed-Releasesнемає даних
Використані вхідні дані
releases_count52
latest_release_tagv0.8.14
releases_from_tagsні
days_since_latest_release0
mean_days_between_releases8,9
Виключено з оцінювання (немає даних або не застосовно): OpenSSF Scorecard: Signed-Releases. Залишкові ваги перенормовано.

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

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

75Добрий · 17% загального індексу
Як обчислюється оцінка
41/60Зірки337 зірок
14.6/25Форки58 форків
2.7/15Спостерігачі4 спостерігачів
Використані вхідні дані
forks58
stars337
watchers4
growth_stateunverified
growth_factor_pct100
growth_unverified_reasonno_history
Як обчислюється оцінка
22.5/22.5README
22.5/22.5Ліцензіявизнана ліцензія (Apache-2.0)
18/18Настанови CONTRIBUTING
13.5/13.5Кодекс поведінки
0/7.2Шаблон issue
6.3/6.3Шаблон PR
Використані вхідні дані
has_readmeтак
has_licenseтак
readme_badges6
has_contributingтак
has_issue_templateні
has_code_of_conductтак
readme_badge_servicesshields.io, www.bestpractices.dev
has_pull_request_templateтак
Як обчислюється оцінка
62.7/80Щомісячні завантаження50 806 завантажень/місяць у pypi
0/20Залежні пакети в реєстріця екосистема цього не повідомляє
Використані вхідні дані
packagesmonocle_apptrace, monocle_test_tools
dependents
ecosystemspypi
total_downloads
monthly_downloads50 806
unverified_packages_excludedmonocle_mcp
Виключено з оцінювання (немає даних або не застосовно): Залежні пакети в реєстрі. Залишкові ваги перенормовано.

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

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

71Добрий · 23% загального індексу
Як обчислюється оцінка
25.2/54Бас-факторна 2 контриб’ютор(ів) припадає половина всіх комітів
14.7/22.5Розподіл комітівголовний контриб’ютор — автор 34% комітів
13.5/13.5Широта контриб’юторів33 контриб’юторів
10/10OpenSSF Scorecard: Contributorsproject has 4 contributing companies or organizations
Використані вхідні дані
bus_factor2
contributors_sampled33
top_contributor_share0,345
Як обчислюється оцінка
22/42Вирішення issueзакрито 52% issue
24.4/30Прийняття PRзлито 533/654 вирішених PR
13/13Newcomer PR acceptanceзлито 2/2 PR від новачків за 30 дн.
15/15OpenSSF Scorecard: Code-Reviewall changesets reviewed
Використані вхідні дані
merged_prs533
open_issues40
closed_issues44
prs_merged_7d3
prs_decided_7d3
prs_merged_30d17
prs_decided_30d18
issue_closed_ratio0,524
closed_unmerged_prs121
first_time_authors_30d2
first_time_prs_merged_30d2
first_time_prs_decided_30d2
Як обчислюється оцінка
30/30Підтримка власникау власності організації
0/20Верифікований домен
12.2/25Охоплення власника48 підписників у monocle2ai
11/25Послужний список7 публічних репозиторіїв, вік облікового запису ~2 р.
Використані вхідні дані
followers48
owner_typeOrganization
is_verifiedні
owner_loginmonocle2ai
public_repos7
account_age_days807

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

100Винятковий
Як обчислюється оцінка
25/25Опубліковано й доступно3 пакет(ів) у pypi
35/35Свіжість публікаційостання публікація 0 дн. тому
20/20Історія версій52 опублікованих версій
20/20Не застарілийактивний, не deprecated і не yanked
Використані вхідні дані
packagesmonocle_mcp, monocle_apptrace, monocle_test_tools
ecosystemspypi
any_deprecatedні
min_days_since_publish0

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

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

85Відмінний · 19% загального індексу
Як обчислюється оцінка
24/24Процеси CI10 процес(ів) CI
24/24Наявні тести
16/16Конфігурація лінтера.pylintrc, apptrace/pyproject.toml ([tool.pylint]), test_tools/pyproject.toml ([tool.ruff], [tool.black]), tox.ini
0/9.6Pre-commit-хуки
0/6.4.editorconfig
18/20OpenSSF Scorecard: CI-Tests28 out of 30 merged PRs checked by a CI test -- score normalized to 9
Використані вхідні дані
has_ciтак
has_testsтак
has_editorconfigні
has_linter_configтак
has_precommit_configні

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

90Відмінний
Як обчислюється оцінка
30/30README
25/25Каталог документації
15/15Сайт документації / домашня сторінкаhttp://monocle2ai.org
10/10Опис репозиторію
10/10Теми13 тем
0/10Wiki
Використані вхідні дані
topicsgenerative-ai, linux-foundation, llms, observability, oss, python, telemetry, tracing, llm-agent, llm-inference, opentelemetry, agentic-ai, multi-agent
has_wikiні
homepagehttp://monocle2ai.org
docs_sitehttp://monocle2ai.org
has_readmeтак
has_docs_dirтак
has_descriptionтак

Безпека

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

69Добрий · 16% загального індексу
Як обчислюється оцінка
7.5/7.5Binary-Artifactsno binaries found in the repo
0/7.5Branch-Protectionнемає даних
2.2/2.5CI-Tests28 out of 30 merged PRs checked by a CI test -- score normalized to 9
1.8/2.5CII-Best-Practicesbadge detected: Silver
7.5/7.5Code-Reviewall changesets reviewed
2.5/2.5Contributorsproject has 4 contributing companies or organizations
10/10Dangerous-Workflowno dangerous workflow patterns detected
0/7.5Dependency-Update-Toolno update tool detected
0/5Fuzzingproject is not fuzzed
2.5/2.5Ліцензіяlicense file detected
7.5/7.5Maintained30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10
5/5Packagingpackaging workflow detected
0/5Pinned-Dependenciesdependency not pinned by hash detected -- score normalized to 0
4.5/5SASTSAST tool detected but not run on all commits
5/5Security-Policysecurity policy file detected
0/7.5Signed-Releasesнемає даних
0/7.5Token-Permissionsdetected GitHub workflow tokens with excessive permissions
7.5/7.5Vulnerabilities0 existing vulnerabilities detected
Використані вхідні дані
sourceopenssf_scorecard
checks_evaluated16
scorecard_versionv5.5.0
checks_inconclusive2
scorecard_aggregate7,1
Виключено з оцінювання (немає даних або не застосовно): Branch-Protection, Signed-Releases. Залишкові ваги перенормовано.
Як обчислюється оцінка
11.6/35Прямі залежності без відомих сповіщеньуражено 2: click 8.2.1 (high 7.2), mcp 1.27.0 (high 7.6)
0/25Непрямі залежності без відомих сповіщеньтранзитивний набір не відокремлюється від залежностей розробки й тестування в цьому обсязі
33.9/40Немає задавнених сповіщень1 пакет(ів) зі сповіщеннями без реакції понад 90 дн.; найдавніше опубліковано 119 дн. тому
Використані вхідні дані
sourceosv
advisories41
affected_packages7
assessed_packages52
unassessed_packages42
affected_by_severitycritical 2, high 3, moderate 1, unknown 1
direct_affected_packages2
Виключено з оцінювання (немає даних або не застосовно): Непрямі залежності без відомих сповіщень. Залишкові ваги перенормовано. Звірено 52 резолвлених залежностей із OSV. 42 не вдалося оцінити — немає резолвленої версії, непідтримувана екосистема або поза межами звітованого переліку пакетів. Цей репозиторій не публікує пакета, який резолвить індекс, тож натомість оцінено граф залежностей репозиторію. Цей граф змішує закріплені версії для розробки й тестування зі справді постачаними залежностями, тож оцінюються лише задекларовані runtime-залежності; транзитивні знахідки подаються як контекст і в оцінку не входять. Досяжність не аналізується.

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

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

57Помірний · 4% загального індексу
Як обчислюється оцінка
0/45Інструкції для агентівнемає CLAUDE.md / AGENTS.md / правил редактора
15/15Машиночитана документація (llms.txt)llms.txt опубліковано на сайті проєкту (https://docs.paygentic.io/llms.txt)
40/40Читабельна історія комітівнамір зазначено у 90 з 94 людських комітів (структурований заголовок або пояснювальний текст)
Використані вхідні дані
has_llms_txtтак
llms_txt_urlhttps://docs.paygentic.io/llms.txt
legible_history_share0,957
agent_instruction_files
agent_instruction_max_bytes
Як обчислюється оцінка
0/18Розгортання однією командою
22/22Автоматизовані тести
11/11Конфігурація лінтера / форматера.pylintrc, apptrace/pyproject.toml ([tool.pylint]), test_tools/pyproject.toml ([tool.ruff], [tool.black]), tox.ini
0/11Статична перевірка типів
0/10Відтворюване середовище
10/10Підтверджена практика роботи з агентами17 з останніх 100 комітів створено агентом або з його зазначенням
0/8Автоматизоване супроводженняавтоматичних оновлень залежностей не виявлено
0/10OpenSSF Scorecard: Pinned-Dependenciesdependency 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
agent_commit_share0,17
toolchain_manifests
dependency_bot_commit_share0
Як обчислюється оцінка
0/45Типізований кодPython без конфігурації перевірки типів
54.8/55Керовані розміри файлів2/615 файлів вихідного коду понад 60 КБ
Використані вхідні дані
primary_languagePython
largest_source_bytes73 963
source_files_sampled615
oversized_source_files2
Як обчислюється оцінка
0/40Схема API (OpenAPI/GraphQL/proto)не застосовно до цього типу програмного забезпечення
20/20Сервер MCP
40/40Придатні до запуску прикладиexamples
Використані вхідні дані
example_dirsexamples
has_mcp_signalтак
api_schema_files
interfaces_expected_of
Виключено з оцінювання (немає даних або не застосовно): Схема API (OpenAPI/GraphQL/proto). Залишкові ваги перенормовано.

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

337зірок GitHub
33контриб'юторів
392комітів за останні 12 місяців
0днів від останнього пушу
52релізів
2бас-фактор
40відкритих issue
PyPIпакетних екосистем

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

  • Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token
  • deps.dev does not index pypi:monocle_mcp@0.8.14; advisories assessed against the repository dependency graph instead

Докладніше

Історія зірок і форків 0 ★ / 58 ⇿
0Зірки
58Форки
50Релізи

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

01020304050605432024-072025-082026-08
Мажорні 0Мінорні 8Патчі 30

Кожна точка охоплює 2 днів.

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

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

10Binary-Artifactsno binaries found in the repo
н/дBranch-Protectioninternal error: error during branchesHandler.setup: internal error: some github tokens can't read classic branch protection rules: https://github.com/ossf/scorecard-action/blob/main/docs/authentication/fine-grained-auth-token.md
9CI-Tests28 out of 30 merged PRs checked by a CI test -- score normalized to 9
7CII-Best-Practicesbadge detected: Silver
10Code-Reviewall changesets reviewed
10Contributorsproject has 4 contributing companies or organizations
10Dangerous-Workflowno dangerous workflow patterns detected
0Dependency-Update-Toolno update 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
10Packagingpackaging workflow detected
0Pinned-Dependenciesdependency not pinned by hash detected -- score normalized to 0
9SASTSAST tool detected but not run on all commits
10Security-Policysecurity policy file detected
н/дSigned-Releasesno releases found
0Token-Permissionsdetected GitHub workflow tokens with excessive permissions
10Vulnerabilities0 existing vulnerabilities detected
Прямі залежності 20
РеєстрПакетОбмеження версіїМаніфест
PyPIrequestsapptrace/pyproject.toml
PyPIwrapt>=1.14.0apptrace/pyproject.toml
PyPIrfc3986>=2.0.0apptrace/pyproject.toml
PyPIopentelemetry-api>=1.20.0,<2.0.0apptrace/pyproject.toml
PyPIopentelemetry-sdk>=1.20.0,<2.0.0apptrace/pyproject.toml
PyPIopentelemetry-instrumentation>=0.41b0apptrace/pyproject.toml
PyPIopentelemetry-exporter-otlp-proto-http>=1.20.0,<2.0.0apptrace/pyproject.toml
PyPIpyyaml>=6.0.2apptrace/pyproject.toml
PyPIclick>=8.0.0mcp/pyproject.toml
PyPImonocle_apptrace>=0.5.0mcp/pyproject.toml
PyPImcp>=1.12.1mcp/pyproject.toml
PyPIpytest>=8.0.0test_tools/pyproject.toml
PyPIpytest-asyncio>=0.26.0test_tools/pyproject.toml
PyPIpydantic>=2.11.7test_tools/pyproject.toml
PyPIjsonschema>=4.0.0test_tools/pyproject.toml
PyPImonocle_apptrace>=0.5.0test_tools/pyproject.toml
PyPIbert-score>=0.3.0test_tools/pyproject.toml
PyPItransformers>=4.0.0test_tools/pyproject.toml
PyPIsentence-transformers>=3.3.0test_tools/pyproject.toml
PyPIGitPython==3.1.58test_tools/pyproject.toml
Усі залежності 94

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

РеєстрПакетВерсіяЗв'язок
PyPIbert-scoreпряма
PyPIclickпряма
PyPIclick8.2.1пряма
PyPIgitpython3.1.58пряма
PyPIjsonschemaпряма
PyPImcpпряма
PyPImcp1.27.0пряма
PyPImonocle-apptraceпряма
PyPIopentelemetry-apiпряма
PyPIopentelemetry-exporter-otlp-proto-httpпряма
PyPIopentelemetry-instrumentationпряма
PyPIopentelemetry-sdkпряма
PyPIpydanticпряма
PyPIpydantic2.11.7пряма
PyPIpytestпряма
PyPIpytest-asyncioпряма
PyPIpyyamlпряма
PyPIrfc3986пряма
PyPIsentence-transformersпряма
PyPItransformersпряма
PyPIwraptпряма
PyPIa2a-sdk0.2.8непряма
PyPIa2a-sdk0.3.6непряма
PyPIagent-framework-core1.5.0непряма
PyPIanthropicнепряма
PyPIanthropic-haystack4.6.0непряма
PyPIazure-functions1.24.0непряма
PyPIazure-storage-blob12.22.0непряма
PyPIbedrock-agentcore1.6.1непряма
PyPIblackнепряма
PyPIboto31.42.86непряма
PyPIchromadbнепряма
PyPIcrewai0.95.0непряма
PyPIdatasets4.3.0непряма
PyPIfaiss-cpu1.8.0непряма
PyPIfastapi0.135.3непряма
PyPIfastmcp2.14.1непряма
PyPIflake8непряма
PyPIgoogle-adkнепряма
PyPIgoogle-cloud-storage2.18.0непряма
PyPIgoogle-generativeaiнепряма
PyPIhaystack-ai3.0.0непряма
PyPIhttpxнепряма
PyPIhttpx0.28.1непряма
PyPIhuggingface-hub0.35.3непряма
PyPIinstructorembedding1.0.1непряма
PyPIlangchain1.2.15непряма
PyPIlangchain-anthropicнепряма
PyPIlangchain-awsнепряма
PyPIlangchain-chromaнепряма
PyPIlangchain-communityнепряма
PyPIlangchain-google-genaiнепряма
PyPIlangchain-mcp-adapters0.2.1непряма
PyPIlangchain-mistralaiнепряма
PyPIlangchain-openaiнепряма
PyPIlangchainhub0.1.21непряма
PyPIlanggraphнепряма
PyPIlanggraph1.1.5непряма
PyPIlanggraph-supervisor0.0.31непряма
PyPIlitellm1.77.5непряма
PyPIllama-indexнепряма
PyPIllama-index0.13.0непряма
PyPIllama-index-embeddings-huggingface0.6.0непряма
PyPIllama-index-llms-anthropic0.8.1непряма
PyPIllama-index-llms-azure-openai0.4.0непряма
PyPIllama-index-llms-gemini0.6.0непряма
PyPIllama-index-llms-mistralai0.7.0непряма
PyPIllama-index-llms-openai0.5.0непряма
PyPIllama-index-tools-mcp0.3.0непряма
PyPIllama-index-vector-stores-chroma0.5.0непряма
PyPIllama-index-vector-stores-opensearch1.1.1непряма
PyPImistral-haystack0.0.2непряма
PyPImistralaiнепряма
PyPImistralai1.9.9непряма
PyPImypyнепряма
PyPInumpy1.26.4непряма
PyPIopenai-agentsнепряма
PyPIopendal0.45.14непряма
PyPIopensearch-haystack8.2.0непряма
PyPIopentelemetry-semantic-conventions0.60b1непряма
PyPIopentelemetry-semantic-conventions-ai0.4.13непряма
PyPIparameterized0.9.0непряма
PyPIpre-commitнепряма
PyPIpresidio-analyzerнепряма
PyPIpresidio-anonymizerнепряма
PyPIpytest-covнепряма
PyPIpython-dotenvнепряма
PyPIrequests-aws4auth1.2.3непряма
PyPIsentence-transformers-haystack0.1.1непряма
PyPIstrands-agents1.11.0непряма
PyPIstrands-agents-tools0.2.10непряма
PyPItypes-requests2.31.0.20240106непряма
PyPIuvicornнепряма
PyPIuvicorn0.44.0непряма
Сповіщення про залежності 7

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

ПакетВерсіяЗв'язокКритичністьСповіщеньВиправлено в
fastmcp2.14.1непрямакритична83.2.0
litellm1.77.5непрямакритична211.84.0
click8.2.1прямависока18.3.3
mcp1.27.0прямависока61.28.1
bedrock-agentcore1.6.1непрямависока21.18.1
langchain1.2.15непрямапомірна21.4.6
datasets4.3.0непряманевідома15.0.1

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

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

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

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

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

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

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

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