Monocle is a framework for tracing GenAI app code. This repo contains implementation of Monocle for GenAI apps written in Python.
monocle2ai/monocle має індекс здоров’я 94 зі 100, що відповідає смузі «Винятковий». Найвищий показник — Vitality (100/100), найнижчий — AI Readiness (57/100). Останнє оновлення — сьогодні. Більшість нещодавньої роботи виконують 2 учасники.
Метрики згруповано у зважені категорії на шкалі 1–100. Загальна оцінка починається як їхнє зважене середнє, відкаліброване за розподілом публічного реєстру, тож діапазони мають перцентильний зміст; коли публічні дані активують Політику юрисдикцій високого ризику, рейтинг коригується й отримує верхню межу 34 («У зоні ризику»).
Кожна вісь — окрема категорія. Форма важить більше, ніж середнє: здоровий об'єкт заповнює всю фігуру, тоді як профіль із піками та провалами означає, що сила в одному вимірі маскує ризик в іншому.
Зважений загальний бал 80 калібровано до 94 за шкалою опублікованого індексу (калібрування реєстру 2026-08-02).
За цим репозиторієм стоїть організація — спільна, підзвітна опіка, здатна пережити будь-якого окремого мейнтейнера.
| Реєстр | Пакет | Версія | Завантажень / міс | Версії | Остання публікація |
|---|---|---|---|---|---|
| PyPI | monocle_mcp | 0.8.14 | 615 | 24 | 0 днів тому |
| PyPI | monocle_apptrace | 0.8.14 | 48 766 | 52 | 0 днів тому |
| PyPI | monocle_test_tools | 0.8.14 | 2 040 | 28 | 0 днів тому |
Чи живий проєкт — чи пишеться код і чи виходять релізи?
| 36/36 | Свіжість push — останній push 0 дн. тому |
| 36/36 | Ритм комітів — 52/52 тижнів із комітами |
| 18/18 | Обсяг комітів — 392 комітів за останній рік |
| 10/10 | OpenSSF Scorecard: Maintained — 30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10 |
| commits_last_year | 392 |
| human_commit_share | 0,94 |
| days_since_last_push | 0 |
| active_weeks_last_year | 52 |
| 27/27 | Випускає релізи — опубліковано 52 релізів |
| 36/36 | Свіжість релізів — останній реліз 0 дн. тому |
| 27/27 | Ритм релізів — реліз кожні ~8,9 дн. |
| 0/10 | OpenSSF Scorecard: Signed-Releases — немає даних |
| releases_count | 52 |
| latest_release_tag | v0.8.14 |
| releases_from_tags | ні |
| days_since_latest_release | 0 |
| mean_days_between_releases | 8,9 |
Чи має проєкт користувачів, завантаження, увагу та влаштовані умови для контриб’юторів?
| 41/60 | Зірки — 337 зірок |
| 14.6/25 | Форки — 58 форків |
| 2.7/15 | Спостерігачі — 4 спостерігачів |
| forks | 58 |
| stars | 337 |
| watchers | 4 |
| growth_state | unverified |
| growth_factor_pct | 100 |
| growth_unverified_reason | no_history |
| 22.5/22.5 | README |
| 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_badges | 6 |
| has_contributing | так |
| has_issue_template | ні |
| has_code_of_conduct | так |
| readme_badge_services | shields.io, www.bestpractices.dev |
| has_pull_request_template | так |
| 62.7/80 | Щомісячні завантаження — 50 806 завантажень/місяць у pypi |
| 0/20 | Залежні пакети в реєстрі — ця екосистема цього не повідомляє |
| packages | monocle_apptrace, monocle_test_tools |
| dependents | — |
| ecosystems | pypi |
| total_downloads | — |
| monthly_downloads | 50 806 |
| unverified_packages_excluded | monocle_mcp |
Чи переживе проєкт своїх людей — бас-фактор, реактивність, хто за ним стоїть і як супроводжуються пакети?
| 25.2/54 | Бас-фактор — на 2 контриб’ютор(ів) припадає половина всіх комітів |
| 14.7/22.5 | Розподіл комітів — головний контриб’ютор — автор 34% комітів |
| 13.5/13.5 | Широта контриб’юторів — 33 контриб’юторів |
| 10/10 | OpenSSF Scorecard: Contributors — project has 4 contributing companies or organizations |
| bus_factor | 2 |
| contributors_sampled | 33 |
| top_contributor_share | 0,345 |
| 22/42 | Вирішення issue — закрито 52% issue |
| 24.4/30 | Прийняття PR — злито 533/654 вирішених PR |
| 13/13 | Newcomer PR acceptance — злито 2/2 PR від новачків за 30 дн. |
| 15/15 | OpenSSF Scorecard: Code-Review — all changesets reviewed |
| merged_prs | 533 |
| open_issues | 40 |
| closed_issues | 44 |
| prs_merged_7d | 3 |
| prs_decided_7d | 3 |
| prs_merged_30d | 17 |
| prs_decided_30d | 18 |
| issue_closed_ratio | 0,524 |
| closed_unmerged_prs | 121 |
| first_time_authors_30d | 2 |
| first_time_prs_merged_30d | 2 |
| first_time_prs_decided_30d | 2 |
| 30/30 | Підтримка власника — у власності організації |
| 0/20 | Верифікований домен |
| 12.2/25 | Охоплення власника — 48 підписників у monocle2ai |
| 11/25 | Послужний список — 7 публічних репозиторіїв, вік облікового запису ~2 р. |
| followers | 48 |
| owner_type | Organization |
| is_verified | ні |
| owner_login | monocle2ai |
| public_repos | 7 |
| account_age_days | 807 |
| 25/25 | Опубліковано й доступно — 3 пакет(ів) у pypi |
| 35/35 | Свіжість публікацій — остання публікація 0 дн. тому |
| 20/20 | Історія версій — 52 опублікованих версій |
| 20/20 | Не застарілий — активний, не deprecated і не yanked |
| packages | monocle_mcp, monocle_apptrace, monocle_test_tools |
| ecosystems | pypi |
| any_deprecated | ні |
| min_days_since_publish | 0 |
Чи наявні базові інженерні практики та документація?
| 24/24 | Процеси CI — 10 процес(ів) CI |
| 24/24 | Наявні тести |
| 16/16 | Конфігурація лінтера — .pylintrc, apptrace/pyproject.toml ([tool.pylint]), test_tools/pyproject.toml ([tool.ruff], [tool.black]), tox.ini |
| 0/9.6 | Pre-commit-хуки |
| 0/6.4 | .editorconfig |
| 18/20 | OpenSSF Scorecard: CI-Tests — 28 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 | ні |
| 30/30 | README |
| 25/25 | Каталог документації |
| 15/15 | Сайт документації / домашня сторінка — http://monocle2ai.org |
| 10/10 | Опис репозиторію |
| 10/10 | Теми — 13 тем |
| 0/10 | Wiki |
| topics | generative-ai, linux-foundation, llms, observability, oss, python, telemetry, tracing, llm-agent, llm-inference, opentelemetry, agentic-ai, multi-agent |
| has_wiki | ні |
| homepage | http://monocle2ai.org |
| docs_site | http://monocle2ai.org |
| has_readme | так |
| has_docs_dir | так |
| has_description | так |
Чи міцні видимі практики безпеки й ланцюга постачання, без непослабленої пов’язаності з юрисдикціями високого ризику?
| 7.5/7.5 | Binary-Artifacts — no binaries found in the repo |
| 0/7.5 | Branch-Protection — немає даних |
| 2.2/2.5 | CI-Tests — 28 out of 30 merged PRs checked by a CI test -- score normalized to 9 |
| 1.8/2.5 | CII-Best-Practices — badge detected: Silver |
| 7.5/7.5 | Code-Review — all changesets reviewed |
| 2.5/2.5 | Contributors — project has 4 contributing companies or organizations |
| 10/10 | Dangerous-Workflow — no dangerous workflow patterns detected |
| 0/7.5 | Dependency-Update-Tool — no update tool detected |
| 0/5 | Fuzzing — project is not fuzzed |
| 2.5/2.5 | Ліцензія — license file detected |
| 7.5/7.5 | Maintained — 30 commit(s) and 0 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 |
| 4.5/5 | SAST — SAST tool detected but not run on all commits |
| 5/5 | Security-Policy — security policy file detected |
| 0/7.5 | Signed-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 | 16 |
| scorecard_version | v5.5.0 |
| checks_inconclusive | 2 |
| scorecard_aggregate | 7,1 |
| 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 дн. тому |
| source | osv |
| advisories | 41 |
| affected_packages | 7 |
| assessed_packages | 52 |
| unassessed_packages | 42 |
| affected_by_severity | critical 2, high 3, moderate 1, unknown 1 |
| direct_affected_packages | 2 |
Наскільки репозиторій оснащений для розробки та супроводу за участі ШІ-агентів? Має свідомо малу вагу (4%): агентний інструментарій — реальний сигнал супроводу, але репозиторій без нього все одно може отримати 100/100.
| 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_url | https://docs.paygentic.io/llms.txt |
| legible_history_share | 0,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/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 | — |
| agent_commit_share | 0,17 |
| toolchain_manifests | — |
| dependency_bot_commit_share | 0 |
| 0/45 | Типізований код — Python без конфігурації перевірки типів |
| 54.8/55 | Керовані розміри файлів — 2/615 файлів вихідного коду понад 60 КБ |
| primary_language | Python |
| largest_source_bytes | 73 963 |
| source_files_sampled | 615 |
| oversized_source_files | 2 |
| 0/40 | Схема API (OpenAPI/GraphQL/proto) — не застосовно до цього типу програмного забезпечення |
| 20/20 | Сервер MCP |
| 40/40 | Придатні до запуску приклади — examples |
| example_dirs | examples |
| has_mcp_signal | так |
| api_schema_files | — |
| interfaces_expected_of | — |
Коли додано кожну зірку й форк — зібрано з GitHub і згруповано за днями. Кумулятивне зростання розміщено просто над денними додаваннями, з яких воно складається, тож їх видно одне проти одного: рівномірне органічне накопичення виглядає зовсім інакше, ніж різкий короткочасний сплеск. Там, де цю різницю можна виміряти, її подано як автентичність росту.
Кожна точка охоплює 2 днів.
Незалежна, не прив'язана до інструментів оцінка безпеки від відкритого проєкту OpenSSF Scorecard. Кожна перевірка винагороджує практику безпеки, а не інструмент конкретного постачальника. Перевірки, які Scorecard не зміг визначити, позначено н/д і виключено з оцінки безпеки (вони ніколи не зараховуються як нуль).
| 10 | Binary-Artifacts | no binaries found in the repo |
| н/д | Branch-Protection | internal 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 |
| 9 | CI-Tests | 28 out of 30 merged PRs checked by a CI test -- score normalized to 9 |
| 7 | CII-Best-Practices | badge detected: Silver |
| 10 | Code-Review | all changesets reviewed |
| 10 | Contributors | project has 4 contributing companies or organizations |
| 10 | Dangerous-Workflow | no dangerous workflow patterns detected |
| 0 | Dependency-Update-Tool | no update tool detected |
| 0 | Fuzzing | project is not fuzzed |
| 10 | License | license file detected |
| 10 | Maintained | 30 commit(s) and 0 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 |
| 9 | SAST | SAST tool detected but not run on all commits |
| 10 | Security-Policy | security policy file detected |
| н/д | Signed-Releases | no releases found |
| 0 | Token-Permissions | detected GitHub workflow tokens with excessive permissions |
| 10 | Vulnerabilities | 0 existing vulnerabilities detected |
| Реєстр | Пакет | Обмеження версії | Маніфест |
|---|---|---|---|
| PyPI | requests | — | apptrace/pyproject.toml |
| PyPI | wrapt | >=1.14.0 | apptrace/pyproject.toml |
| PyPI | rfc3986 | >=2.0.0 | apptrace/pyproject.toml |
| PyPI | opentelemetry-api | >=1.20.0,<2.0.0 | apptrace/pyproject.toml |
| PyPI | opentelemetry-sdk | >=1.20.0,<2.0.0 | apptrace/pyproject.toml |
| PyPI | opentelemetry-instrumentation | >=0.41b0 | apptrace/pyproject.toml |
| PyPI | opentelemetry-exporter-otlp-proto-http | >=1.20.0,<2.0.0 | apptrace/pyproject.toml |
| PyPI | pyyaml | >=6.0.2 | apptrace/pyproject.toml |
| PyPI | click | >=8.0.0 | mcp/pyproject.toml |
| PyPI | monocle_apptrace | >=0.5.0 | mcp/pyproject.toml |
| PyPI | mcp | >=1.12.1 | mcp/pyproject.toml |
| PyPI | pytest | >=8.0.0 | test_tools/pyproject.toml |
| PyPI | pytest-asyncio | >=0.26.0 | test_tools/pyproject.toml |
| PyPI | pydantic | >=2.11.7 | test_tools/pyproject.toml |
| PyPI | jsonschema | >=4.0.0 | test_tools/pyproject.toml |
| PyPI | monocle_apptrace | >=0.5.0 | test_tools/pyproject.toml |
| PyPI | bert-score | >=0.3.0 | test_tools/pyproject.toml |
| PyPI | transformers | >=4.0.0 | test_tools/pyproject.toml |
| PyPI | sentence-transformers | >=3.3.0 | test_tools/pyproject.toml |
| PyPI | GitPython | ==3.1.58 | test_tools/pyproject.toml |
Повний розв'язаний набір залежностей із графа залежностей GitHub: 21 прямих і 73 непрямих (транзитивних) пакетів. Транзитивне замикання є повним, коли в репозиторії закомічено lockfile.
| Реєстр | Пакет | Версія | Зв'язок |
|---|---|---|---|
| PyPI | bert-score | — | пряма |
| PyPI | click | — | пряма |
| PyPI | click | 8.2.1 | пряма |
| PyPI | gitpython | 3.1.58 | пряма |
| PyPI | jsonschema | — | пряма |
| PyPI | mcp | — | пряма |
| PyPI | mcp | 1.27.0 | пряма |
| PyPI | monocle-apptrace | — | пряма |
| PyPI | opentelemetry-api | — | пряма |
| PyPI | opentelemetry-exporter-otlp-proto-http | — | пряма |
| PyPI | opentelemetry-instrumentation | — | пряма |
| PyPI | opentelemetry-sdk | — | пряма |
| PyPI | pydantic | — | пряма |
| PyPI | pydantic | 2.11.7 | пряма |
| PyPI | pytest | — | пряма |
| PyPI | pytest-asyncio | — | пряма |
| PyPI | pyyaml | — | пряма |
| PyPI | rfc3986 | — | пряма |
| PyPI | sentence-transformers | — | пряма |
| PyPI | transformers | — | пряма |
| PyPI | wrapt | — | пряма |
| PyPI | a2a-sdk | 0.2.8 | непряма |
| PyPI | a2a-sdk | 0.3.6 | непряма |
| PyPI | agent-framework-core | 1.5.0 | непряма |
| PyPI | anthropic | — | непряма |
| PyPI | anthropic-haystack | 4.6.0 | непряма |
| PyPI | azure-functions | 1.24.0 | непряма |
| PyPI | azure-storage-blob | 12.22.0 | непряма |
| PyPI | bedrock-agentcore | 1.6.1 | непряма |
| PyPI | black | — | непряма |
| PyPI | boto3 | 1.42.86 | непряма |
| PyPI | chromadb | — | непряма |
| PyPI | crewai | 0.95.0 | непряма |
| PyPI | datasets | 4.3.0 | непряма |
| PyPI | faiss-cpu | 1.8.0 | непряма |
| PyPI | fastapi | 0.135.3 | непряма |
| PyPI | fastmcp | 2.14.1 | непряма |
| PyPI | flake8 | — | непряма |
| PyPI | google-adk | — | непряма |
| PyPI | google-cloud-storage | 2.18.0 | непряма |
| PyPI | google-generativeai | — | непряма |
| PyPI | haystack-ai | 3.0.0 | непряма |
| PyPI | httpx | — | непряма |
| PyPI | httpx | 0.28.1 | непряма |
| PyPI | huggingface-hub | 0.35.3 | непряма |
| PyPI | instructorembedding | 1.0.1 | непряма |
| PyPI | langchain | 1.2.15 | непряма |
| PyPI | langchain-anthropic | — | непряма |
| PyPI | langchain-aws | — | непряма |
| PyPI | langchain-chroma | — | непряма |
| PyPI | langchain-community | — | непряма |
| PyPI | langchain-google-genai | — | непряма |
| PyPI | langchain-mcp-adapters | 0.2.1 | непряма |
| PyPI | langchain-mistralai | — | непряма |
| PyPI | langchain-openai | — | непряма |
| PyPI | langchainhub | 0.1.21 | непряма |
| PyPI | langgraph | — | непряма |
| PyPI | langgraph | 1.1.5 | непряма |
| PyPI | langgraph-supervisor | 0.0.31 | непряма |
| PyPI | litellm | 1.77.5 | непряма |
| PyPI | llama-index | — | непряма |
| PyPI | llama-index | 0.13.0 | непряма |
| PyPI | llama-index-embeddings-huggingface | 0.6.0 | непряма |
| PyPI | llama-index-llms-anthropic | 0.8.1 | непряма |
| PyPI | llama-index-llms-azure-openai | 0.4.0 | непряма |
| PyPI | llama-index-llms-gemini | 0.6.0 | непряма |
| PyPI | llama-index-llms-mistralai | 0.7.0 | непряма |
| PyPI | llama-index-llms-openai | 0.5.0 | непряма |
| PyPI | llama-index-tools-mcp | 0.3.0 | непряма |
| PyPI | llama-index-vector-stores-chroma | 0.5.0 | непряма |
| PyPI | llama-index-vector-stores-opensearch | 1.1.1 | непряма |
| PyPI | mistral-haystack | 0.0.2 | непряма |
| PyPI | mistralai | — | непряма |
| PyPI | mistralai | 1.9.9 | непряма |
| PyPI | mypy | — | непряма |
| PyPI | numpy | 1.26.4 | непряма |
| PyPI | openai-agents | — | непряма |
| PyPI | opendal | 0.45.14 | непряма |
| PyPI | opensearch-haystack | 8.2.0 | непряма |
| PyPI | opentelemetry-semantic-conventions | 0.60b1 | непряма |
| PyPI | opentelemetry-semantic-conventions-ai | 0.4.13 | непряма |
| PyPI | parameterized | 0.9.0 | непряма |
| PyPI | pre-commit | — | непряма |
| PyPI | presidio-analyzer | — | непряма |
| PyPI | presidio-anonymizer | — | непряма |
| PyPI | pytest-cov | — | непряма |
| PyPI | python-dotenv | — | непряма |
| PyPI | requests-aws4auth | 1.2.3 | непряма |
| PyPI | sentence-transformers-haystack | 0.1.1 | непряма |
| PyPI | strands-agents | 1.11.0 | непряма |
| PyPI | strands-agents-tools | 0.2.10 | непряма |
| PyPI | types-requests | 2.31.0.20240106 | непряма |
| PyPI | uvicorn | — | непряма |
| PyPI | uvicorn | 0.44.0 | непряма |
Цей репозиторій не публікує пакета, який розпізнає індекс, тож оцінено його власний граф залежностей — 52 пакетів, серед яких є й піниї розробки та тестування, що ніколи не постачаються: 7 мають відомі сповіщення, з них 2 прямі. 42 не вдалося оцінити — немає резолвленої версії, непідтримувана екосистема або поза наведеним переліком пакетів.
| Пакет | Версія | Зв'язок | Критичність | Сповіщень | Виправлено в |
|---|---|---|---|---|---|
| fastmcp | 2.14.1 | непряма | критична | 8 | 3.2.0 |
| litellm | 1.77.5 | непряма | критична | 21 | 1.84.0 |
| click | 8.2.1 | пряма | висока | 1 | 8.3.3 |
| mcp | 1.27.0 | пряма | висока | 6 | 1.28.1 |
| bedrock-agentcore | 1.6.1 | непряма | висока | 2 | 1.18.1 |
| langchain | 1.2.15 | непряма | помірна | 2 | 1.4.6 |
| datasets | 4.3.0 | непряма | невідома | 1 | 5.0.1 |
Сповіщення означає, що версія, записана в графі залежностей, потрапляє в уражений діапазон. Досяжність не аналізується, а граф містить піниї розробки й тестування — знахідка може стосуватися інструментів, а не поставленого коду.
Помітили щось хибне у цьому звіті або маєте чим поділитися? Неправильні вимірювання, непомічені інструменти, ідеї, запитання — усе доречно. Кожне повідомлення читається й отримує відповідь.
Оцінки — це сигнали, а не гарантії. Вони відображають публічно видимі практики на GitHub — це не аудит коду й не гарантія безпеки.
Відсутні дані виключаються, а ваги перенормовуються — нуль за відсутність ніколи не ставиться. Методологія версіонована й відкрита: метрики v2.10.0, схема v0.34.0 — повна методологія · вікі метрик.
Як окремий результат виглядає на тлі всього реєстру: сукупна статистика — PyPI.