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

sunglasses-dev / sunglasses

Open source input firewall for AI agents, beta. A local scanner checks text, code, PDFs, images, QR codes, audio and video with 1,583 patterns across 117 categories and reports findings and incomplete scans. A Claude Code hook blocks secret material in tool calls and the paths and hosts your policy lists before tools run.

PythonMIT★ 10 зірок⑂ 3 форкиз бер. 2026 р.Переглянути на GitHub ↗
ТипІнструмент командного рядкаБібліотекаяк це визначено
#agent-security#ai-agents#ai-security#cybersecurity#llm-security#open-source-ai#prompt-injection#supply-chain-security#ai-agent-security#ai-safety#anthropic#claude#llm#mcp#mcp-security#model-context-protocol#prompt-injection-detection#python#security-scanner#tool-poisoning

sunglasses-dev/sunglasses має індекс здоров’я 73 зі 100, що відповідає смузі «Добрий». Найвищий показник — Vitality (86/100), найнижчий — Sustainability & Governance (48/100). Останнє оновлення — сьогодні. Більшість нещодавньої роботи виконує один учасник.

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

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

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

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

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

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

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

Власність

SunglassesОрганізація
7 підписників4 публічні репозиторіїз бер. 2026 р.

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

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

РеєстрПакетВерсіяЗавантажень / місВерсіїОстання публікаціяТеги
PyPIsunglasses0.6.101 8561130 днів томуprompt-injectionmcpai-agent-securityllm-firewallclaude-codetool-poisoning

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

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

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

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

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

84Відмінний
Як обчислюється оцінка
36/36Свіжість push — останній push 0 дн. тому
20.1/36Ритм комітів — 29/52 тижнів із комітами
18/18Обсяг комітів — 497 комітів за останній рік
10/10OpenSSF Scorecard: Maintained — 30 commit(s) and 1 issue activity found in the last 90 days -- score normalized to 10
Використані вхідні дані
commits_last_year497
human_commit_share1
days_since_last_push0
active_weeks_last_year29

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

90Відмінний
Як обчислюється оцінка
27/27Випускає релізи — опубліковано 59 релізів
36/36Свіжість релізів — останній реліз 0 дн. тому
27/27Ритм релізів — реліз кожні ~2,6 дн.
0/10OpenSSF Scorecard: Signed-Releases — Project has not signed or included provenance with any releases.
Використані вхідні дані
releases_count59
latest_release_tagv0.6.10
releases_from_tagsні
days_since_latest_release0
mean_days_between_releases2,6

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

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

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

Популярність і впровадження

18Критичний
Як обчислюється оцінка
15.5/60Зірки — 10 зірок
2.5/25Форки — 3 форків
0/15Спостерігачі — 0 спостерігачів
Використані вхідні дані
forks3
stars10
watchers0
growth_stateunverified
growth_factor_pct100
growth_unverified_reasonno_history

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

92Відмінний
Як обчислюється оцінка
22.5/22.5README
22.5/22.5Ліцензія — визнана ліцензія (MIT)
18/18Настанови CONTRIBUTING
13.5/13.5Кодекс поведінки
0/7.2Шаблон issue
6.3/6.3Шаблон PR
Використані вхідні дані
has_readmeтак
has_licenseтак
readme_badges5
has_contributingтак
has_issue_templateні
has_code_of_conductтак
readme_badge_servicesgithub.com, shields.io
has_pull_request_templateтак

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

54Помірний
Як обчислюється оцінка
43.6/80Щомісячні завантаження — 1 856 завантажень/місяць у pypi
0/20Залежні пакети в реєстрі — ця екосистема цього не повідомляє
Використані вхідні дані
packagessunglasses
dependents—
ecosystemspypi
total_downloads—
monthly_downloads1 856
unverified_packages_excluded—
Виключено з оцінювання (немає даних або не застосовно): Залежні пакети в реєстрі. Залишкові ваги перенормовано.

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

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

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

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

13Критичний
Як обчислюється оцінка
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

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

54Помірний
Як обчислюється оцінка
18/42Вирішення issue — закрито 43% issue
28.6/30Прийняття PR — злито 388/407 вирішених PR
0/13Newcomer PR acceptance — за 30 дн. не вирішено жодного PR від новачка
0/15OpenSSF Scorecard: Code-Review — Found 0/30 approved changesets -- score normalized to 0
Використані вхідні дані
merged_prs388
open_issues4
closed_issues3
prs_merged_7d51
prs_decided_7d60
prs_merged_30d51
prs_decided_30d60
issue_closed_ratio0,429
closed_unmerged_prs19
first_time_authors_30d0
first_time_prs_merged_30d0
first_time_prs_decided_30d0
Виключено з оцінювання (немає даних або не застосовно): Newcomer PR acceptance. Залишкові ваги перенормовано.

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

43Слабкий
Як обчислюється оцінка
30/30Підтримка власника — у власності організації
0/20Верифікований домен
6.5/25Охоплення власника — 7 підписників у sunglasses-dev
6.2/25Послужний список — 4 публічних репозиторіїв, вік облікового запису ~0 р.
Використані вхідні дані
followers7
owner_typeOrganization
is_verifiedні
owner_loginsunglasses-dev
public_repos4
account_age_days203

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

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

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

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

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

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

68Добрий
Як обчислюється оцінка
24/24Процеси CI — 6 процес(ів) CI
24/24Наявні тести
0/16Конфігурація лінтера
0/9.6Pre-commit-хуки
0/6.4.editorconfig
20/20OpenSSF Scorecard: CI-Tests — 30 out of 30 merged PRs checked by a CI test -- score normalized to 10
Використані вхідні дані
has_ciтак
has_testsтак
has_editorconfigні
has_linter_configні
has_precommit_configні

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

90Відмінний
Як обчислюється оцінка
30/30README
25/25Каталог документації
15/15Сайт документації / домашня сторінка — https://sunglasses.dev
10/10Опис репозиторію
10/10Теми — 20 тем
0/10Wiki
Використані вхідні дані
topicsagent-security, ai-agents, ai-security, cybersecurity, llm-security, open-source-ai, prompt-injection, supply-chain-security, ai-agent-security, ai-safety, anthropic, claude, llm, mcp, mcp-security, model-context-protocol, prompt-injection-detection, python, security-scanner, tool-poisoning
has_wikiні
homepagehttps://sunglasses.dev
docs_sitehttps://sunglasses.dev
has_readmeтак
has_docs_dirтак
has_descriptionтак

Безпека

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

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

Стан безпеки

56Помірний
Як обчислюється оцінка
7.5/7.5Binary-Artifacts — no binaries found in the repo
2.2/7.5Branch-Protection — branch protection is not maximal on development and all release branches
2.5/2.5CI-Tests — 30 out of 30 merged PRs checked by a CI test -- score normalized to 10
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
0/7.5Dependency-Update-Tool — no update tool detected
0/5Fuzzing — project is not fuzzed
2.5/2.5Ліцензія — license file detected
7.5/7.5Maintained — 30 commit(s) and 1 issue activity found in the last 90 days -- score normalized to 10
5/5Packaging — packaging workflow detected
1/5Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 2
0/5SAST — SAST tool is not run on all commits -- score normalized to 0
5/5Security-Policy — security policy file detected
0/7.5Signed-Releases — Project has not signed or included provenance with any releases.
7.5/7.5Token-Permissions — GitHub workflow tokens follow principle of least privilege
7.5/7.5Vulnerabilities — 0 existing vulnerabilities detected
Використані вхідні дані
sourceopenssf_scorecard
checks_evaluated18
scorecard_versionv5.5.0
checks_inconclusive0
scorecard_aggregate5,6

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

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

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

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

100Винятковий
Як обчислюється оцінка
45/45Інструкції для агентів — AGENTS.md, CLAUDE.md, tests/repo_ladder_corpus/AgriciDaniel__claude-seo/AGENTS.md, tests/repo_ladder_corpus/AgriciDaniel__claude-seo/CLAUDE.md, tests/repo_ladder_corpus/coreyhaines31__marketingskills/AGENTS.md, tests/repo_ladder_corpus/coreyhaines31__marketingskills/CLAUDE.md, tests/repo_ladder_corpus/huggingface__transformers/AGENTS.md, tests/repo_ladder_corpus/huggingface__transformers/CLAUDE.md, tests/repo_ladder_corpus/langchain-ai__langchain/AGENTS.md, tests/repo_ladder_corpus/langchain-ai__langchain/CLAUDE.md, tests/repo_ladder_corpus/mempalace__mempalace/AGENTS.md, tests/repo_ladder_corpus/mempalace__mempalace/CLAUDE.md, tests/repo_ladder_corpus/modelcontextprotocol__servers/CLAUDE.md, tests/repo_ladder_corpus/pytorch__pytorch/AGENTS.md, tests/repo_ladder_corpus/pytorch__pytorch/CLAUDE.md
15/15Машиночитана документація (llms.txt) — llms.txt опубліковано на сайті проєкту (https://sunglasses.dev/llms.txt)
40/40Читабельна історія комітів — намір зазначено у 100 з 100 людських комітів (структурований заголовок або пояснювальний текст)
Використані вхідні дані
has_llms_txtтак
llms_txt_urlhttps://sunglasses.dev/llms.txt
legible_history_share1
agent_instruction_filesAGENTS.md, CLAUDE.md, tests/repo_ladder_corpus/AgriciDaniel__claude-seo/AGENTS.md, tests/repo_ladder_corpus/AgriciDaniel__claude-seo/CLAUDE.md, tests/repo_ladder_corpus/coreyhaines31__marketingskills/AGENTS.md, tests/repo_ladder_corpus/coreyhaines31__marketingskills/CLAUDE.md, tests/repo_ladder_corpus/huggingface__transformers/AGENTS.md, tests/repo_ladder_corpus/huggingface__transformers/CLAUDE.md, tests/repo_ladder_corpus/langchain-ai__langchain/AGENTS.md, tests/repo_ladder_corpus/langchain-ai__langchain/CLAUDE.md, tests/repo_ladder_corpus/mempalace__mempalace/AGENTS.md, tests/repo_ladder_corpus/mempalace__mempalace/CLAUDE.md, tests/repo_ladder_corpus/modelcontextprotocol__servers/CLAUDE.md, tests/repo_ladder_corpus/pytorch__pytorch/AGENTS.md, tests/repo_ladder_corpus/pytorch__pytorch/CLAUDE.md
agent_instruction_max_bytes18 831

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

42Слабкий
Як обчислюється оцінка
0/18Розгортання однією командою
22/22Автоматизовані тести
0/11Конфігурація лінтера / форматера
0/11Статична перевірка типів
10/10Відтворюване середовище — Dockerfile
8/10Підтверджена практика роботи з агентами — 4 з останніх 100 комітів створено агентом або з його зазначенням
0/8Автоматизоване супроводження — автоматичних оновлень залежностей не виявлено
2/10OpenSSF Scorecard: Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 2
Використані вхідні дані
has_nixні
has_testsтак
lockfiles—
has_dockerfileтак
typed_languageні
bootstrap_files—
has_devcontainerні
has_linter_configні
typecheck_configs—
agent_commit_share0,04
toolchain_manifests—
dependency_bot_commit_share0

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

53Помірний
Як обчислюється оцінка
0/45Типізований код — Python без конфігурації перевірки типів
53.1/55Керовані розміри файлів — 19/553 файлів вихідного коду понад 60 КБ
Використані вхідні дані
primary_languagePython
largest_source_bytes2 278 749
source_files_sampled553
oversized_source_files19

Машиночитні інтерфейси

33У зоні ризику
Як обчислюється оцінка
0/40Схема API (OpenAPI/GraphQL/proto) — не застосовно до цього типу програмного забезпечення
20/20Сервер MCP
0/40Придатні до запуску приклади
Використані вхідні дані
example_dirs—
has_mcp_signalтак
api_schema_files—
interfaces_expected_of—
Виключено з оцінювання (немає даних або не застосовно): Схема API (OpenAPI/GraphQL/proto). Залишкові ваги перенормовано.

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

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

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

  • Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token
  • deps.dev does not index pypi:sunglasses@0.6.10; advisories assessed against the repository dependency graph instead
  • No resolved dependencies carried a version and a supported ecosystem

Докладніше

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

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

12233312026-042026-062026-09
Мажорні 0Мінорні 3Патчі 46
OpenSSF Scorecard 5.6 / 10
5.6сукупно

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

10Binary-Artifactsno binaries found in the repo
3Branch-Protectionbranch protection is not maximal on development and all release branches
10CI-Tests30 out of 30 merged PRs checked by a CI test -- score normalized to 10
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
0Dependency-Update-Toolno update tool detected
0Fuzzingproject is not fuzzed
10Licenselicense file detected
10Maintained30 commit(s) and 1 issue activity found in the last 90 days -- score normalized to 10
10Packagingpackaging workflow detected
2Pinned-Dependenciesdependency not pinned by hash detected -- score normalized to 2
0SASTSAST tool is not run on all commits -- score normalized to 0
10Security-Policysecurity policy file detected
0Signed-ReleasesProject has not signed or included provenance with any releases.
10Token-PermissionsGitHub workflow tokens follow principle of least privilege
10Vulnerabilities0 existing vulnerabilities detected
Усі залежності 8

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

РеєстрПакетВерсіяЗв'язок
PyPIcryptography—непряма
PyPIopenai-whisper—непряма
PyPIpillow—непряма
PyPIpypdf2—непряма
PyPIpytesseract—непряма
PyPIpytest—непряма
PyPIpyyaml—непряма
PyPIpyzbar—непряма
Сповіщення про залежності не оцінено

Звірка сповіщень не відбулася для цього звіту: No resolved dependencies carried a version and a supported ecosystem

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

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

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

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

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

Перевірені репозиторії, що мають спільні каталожні теги або екосистеми з sunglasses-dev/sunglasses. Читати поруч →

99awslabs/cli-agent-orchestratorMulti-agent orchestration for AI coding CLIs — Claude Code, Kiro, Codex, and more, coordinated in isolated tmux sessionsВинятковий100deepset-ai/haystackOpen-source AI orchestration framework for building context-engineered, production-ready LLM applications. Design modular pipelines and agent workflows with explicit control over retrieval, routing, memory, and generation. Built for scalable agents, RAG, multimodal applications, semantic search, and conversational systems.Винятковий98langchain-ai/langchainThe agent engineering platform.Винятковий98strands-agents/toolsA set of tools that gives agents powerful capabilities.Винятковий98ComposioHQ/composioComposio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.Винятковий100stacklok/toolhiveToolHive is an enterprise-grade platform for running and managing Model Context Protocol (MCP) servers.Винятковий

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

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

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