veyliss / ai-localbase
一个本地优先的AI知识库系统（RAG），用于把本地文档接入辅导搜索与大模型对话流程。目前支持md、txt、pdf（文本）、xlsx、cvs类型。支持mcp服务
veyliss/ai-localbase має індекс здоров’я 63 зі 100, що відповідає смузі «Помірний». Найвищий показник — AI Readiness (84/100), найнижчий — Sustainability & Governance (31/100). Останнє оновлення було 5 днів тому. Більшість нещодавньої роботи виконує один учасник.
Індекс здоров'я програмного забезпечення
Метрики згруповано у зважені категорії на шкалі 1–100. Загальна оцінка починається як їхнє зважене середнє, відкаліброване за розподілом публічного реєстру, тож діапазони мають перцентильний зміст; коли публічні дані активують Політику юрисдикцій високого ризику, рейтинг коригується й отримує верхню межу 34 («У зоні ризику»).
Профіль оцінок
Кожна вісь — окрема категорія. Форма важить більше, ніж середнє: здоровий об'єкт заповнює всю фігуру, тоді як профіль із піками та провалами означає, що сила в одному вимірі маскує ризик в іншому.
Зважений загальний бал 59 калібровано до 63 за шкалою опублікованого індексу (калібрування реєстру 2026-08-02).
Власність
Цей репозиторій належить особистому обліковому запису. Проєкт з єдиним власником несе більший ризик безперервності, ніж підтримуваний організацією.
Метрики за категоріями
Життєздатність
Чи живий проєкт — чи пишеться код і чи виходять релізи?
Активність розробки
Як обчислюється оцінка
| 36/36 | Свіжість push — останній push 5 дн. тому |
| 8.3/36 | Ритм комітів — 12/52 тижнів із комітами |
| 18/18 | Обсяг комітів — 157 комітів за останній рік |
| 10/10 | OpenSSF Scorecard: Maintained — 30 commit(s) and 2 issue activity found in the last 90 days -- score normalized to 10 |
Використані вхідні дані
| commits_last_year | 157 |
| human_commit_share | 1 |
| days_since_last_push | 5 |
| active_weeks_last_year | 12 |
Дисципліна релізів
Як обчислюється оцінка
| 27/27 | Випускає релізи — опубліковано 26 релізів |
| 36/36 | Свіжість релізів — останній реліз 5 дн. тому |
| 27/27 | Ритм релізів — реліз кожні ~2,9 дн. |
| 0/10 | OpenSSF Scorecard: Signed-Releases — немає даних |
Використані вхідні дані
| releases_count | 26 |
| latest_release_tag | v1.4.1 |
| releases_from_tags | ні |
| days_since_latest_release | 5 |
| mean_days_between_releases | 2,9 |
Спільнота та впровадження
Чи має проєкт користувачів, завантаження, увагу та влаштовані умови для контриб’юторів?
Популярність і впровадження
Як обчислюється оцінка
| 41.3/60 | Зірки — 352 зірок |
| 13.9/25 | Форки — 48 форків |
| 0/15 | Спостерігачі — 1 спостерігачів |
Використані вхідні дані
| forks | 48 |
| stars | 352 |
| watchers | 1 |
| growth_state | organic |
| growth_factor_pct | 100 |
Здоров'я спільноти
Як обчислюється оцінка
| 22.5/22.5 | README |
| 22.5/22.5 | Ліцензія — визнана ліцензія (MIT) |
| 18/18 | Настанови CONTRIBUTING |
| 0/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 | ні |
Сталість та врядування
Чи переживе проєкт своїх людей — бас-фактор, реактивність, хто за ним стоїть і як супроводжуються пакети?
Стійкість мейнтейнерів (бас-фактор)
Як обчислюється оцінка
| 9/54 | Бас-фактор — на 1 контриб’ютор(ів) припадає половина всіх комітів |
| 0.1/22.5 | Розподіл комітів — головний контриб’ютор — автор 99% комітів |
| 2.7/13.5 | Широта контриб’юторів — 2 контриб’юторів |
| 0/10 | OpenSSF Scorecard: Contributors — project has 0 contributing companies or organizations -- score normalized to 0 |
Використані вхідні дані
| bus_factor | 1 |
| contributors_sampled | 2 |
| top_contributor_share | 0,994 |
Реактивність на issue та PR
Як обчислюється оцінка
| 21/42 | Вирішення issue — закрито 50% issue |
| 15/30 | Прийняття PR — злито 1/2 вирішених PR |
| 0/13 | Newcomer PR acceptance — за 30 дн. не вирішено жодного PR від новачка |
| 0/15 | OpenSSF Scorecard: Code-Review — Found 0/30 approved changesets -- score normalized to 0 |
Використані вхідні дані
| merged_prs | 1 |
| open_issues | 1 |
| closed_issues | 1 |
| prs_merged_7d | — |
| prs_decided_7d | — |
| prs_merged_30d | — |
| prs_decided_30d | — |
| issue_closed_ratio | 0,5 |
| closed_unmerged_prs | 1 |
| first_time_authors_30d | — |
| first_time_prs_merged_30d | — |
| first_time_prs_decided_30d | — |
Власність та опіка
Як обчислюється оцінка
| 10/30 | Підтримка власника — особистий (користувацький) обліковий запис |
| 0/20 | Верифікований домен — не застосовно до користувацьких облікових записів |
| 6.5/25 | Охоплення власника — 7 підписників у veyliss |
| 18.3/25 | Послужний список — 22 публічних репозиторіїв, вік облікового запису ~4 р. |
Використані вхідні дані
| followers | 7 |
| owner_type | User |
| is_verified | — |
| owner_login | veyliss |
| public_repos | 22 |
| account_age_days | 1 527 |
Інженерна якість
Чи наявні базові інженерні практики та документація?
Інженерні практики
Як обчислюється оцінка
| 24/24 | Процеси CI — 3 процес(ів) CI |
| 24/24 | Наявні тести |
| 16/16 | Конфігурація лінтера — .eslintrc.cjs |
| 0/9.6 | Pre-commit-хуки |
| 0/6.4 | .editorconfig |
| 0/20 | OpenSSF Scorecard: CI-Tests — немає даних |
Використані вхідні дані
| has_ci | так |
| has_tests | так |
| has_editorconfig | ні |
| has_linter_config | так |
| has_precommit_config | ні |
Документація
Як обчислюється оцінка
| 30/30 | README |
| 25/25 | Каталог документації |
| 0/15 | Сайт документації / домашня сторінка |
| 10/10 | Опис репозиторію |
| 10/10 | Теми — 8 тем |
| 0/10 | Wiki |
Використані вхідні дані
| topics | ai, go, ollama, qdrant, rag, react, knowledge-base, mcp |
| has_wiki | ні |
| homepage | — |
| docs_site | — |
| has_readme | так |
| has_docs_dir | так |
| has_description | так |
Безпека
Чи міцні видимі практики безпеки й ланцюга постачання, без непослабленої пов’язаності з юрисдикціями високого ризику?
Стан безпеки
Як обчислюється оцінка
| 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 |
| 0/2.5 | CI-Tests — немає даних |
| 0/2.5 | CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected |
| 0/7.5 | Code-Review — Found 0/30 approved changesets -- score normalized to 0 |
| 0/2.5 | Contributors — project has 0 contributing companies or organizations -- score normalized to 0 |
| 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 2 issue activity found in the last 90 days -- score normalized to 10 |
| 5/5 | Packaging — packaging workflow detected |
| 0.5/5 | Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 1 |
| 0/5 | SAST — no SAST tool detected |
| 2/5 | Security-Policy — security policy file detected |
| 0/7.5 | Signed-Releases — немає даних |
| 0/7.5 | Token-Permissions — detected GitHub workflow tokens with excessive permissions |
| 0/7.5 | Vulnerabilities — 29 existing vulnerabilities detected |
Використані вхідні дані
| source | openssf_scorecard |
| checks_evaluated | 16 |
| scorecard_version | v5.5.0 |
| checks_inconclusive | 2 |
| scorecard_aggregate | 3,7 |
Готовність до ШІ
Наскільки репозиторій оснащений для розробки та супроводу за участі ШІ-агентів? Має свідомо малу вагу (4%): агентний інструментарій — реальний сигнал супроводу, але репозиторій без нього все одно може отримати 100/100.
Контекст і настанови для агентів
Як обчислюється оцінка
| 45/45 | Інструкції для агентів — AGENTS.md |
| 0/15 | Машиночитана документація (llms.txt) |
| 40/40 | Читабельна історія комітів — намір зазначено у 95 з 100 людських комітів (структурований заголовок або пояснювальний текст) |
Використані вхідні дані
| has_llms_txt | ні |
| llms_txt_url | — |
| legible_history_share | 0,95 |
| agent_instruction_files | AGENTS.md |
| agent_instruction_max_bytes | 350 |
Як обчислюється оцінка
| 12.6/18 | Розгортання однією командою — backend/go.mod (домовленість інструментарію, без раннера задач) |
| 22/22 | Автоматизовані тести |
| 11/11 | Конфігурація лінтера / форматера — .eslintrc.cjs |
| 11/11 | Статична перевірка типів — frontend/tsconfig.json |
| 10/10 | Відтворюване середовище — Dockerfile, lockfile |
| 10/10 | Підтверджена практика роботи з агентами — 10 з останніх 100 комітів створено агентом або з його зазначенням |
| 0/8 | Автоматизоване супроводження — автоматичних оновлень залежностей не виявлено |
| 1/10 | OpenSSF Scorecard: Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 1 |
Використані вхідні дані
| has_nix | ні |
| has_tests | так |
| lockfiles | go.sum, package-lock.json |
| has_dockerfile | так |
| typed_language | так |
| bootstrap_files | — |
| has_devcontainer | ні |
| has_linter_config | так |
| typecheck_configs | frontend/tsconfig.json |
| agent_commit_share | 0,1 |
| toolchain_manifests | backend/go.mod |
| dependency_bot_commit_share | 0 |
Читабельність коду для моделей
Як обчислюється оцінка
| 45/45 | Типізований код — Go (статично типізована) |
| 53.2/55 | Керовані розміри файлів — 5/153 файлів вихідного коду понад 60 КБ |
Використані вхідні дані
| primary_language | Go |
| largest_source_bytes | 170 004 |
| source_files_sampled | 153 |
| oversized_source_files | 5 |
Ключові факти
Попередження щодо збору даних
- GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository
Докладніше
Історія зірок і форків 352 ★ / 48 ⇿
Коли додано кожну зірку й форк — зібрано з GitHub і згруповано за днями. Кумулятивне зростання розміщено просто над денними додаваннями, з яких воно складається, тож їх видно одне проти одного: рівномірне органічне накопичення виглядає зовсім інакше, ніж різкий короткочасний сплеск. Там, де цю різницю можна виміряти, її подано як автентичність росту.
OpenSSF Scorecard 3.7 / 10
Незалежна, не прив'язана до інструментів оцінка безпеки від відкритого проєкту OpenSSF Scorecard. Кожна перевірка винагороджує практику безпеки, а не інструмент конкретного постачальника. Перевірки, які Scorecard не зміг визначити, позначено н/д і виключено з оцінки безпеки (вони ніколи не зараховуються як нуль).
| 10 | Binary-Artifacts | no binaries found in the repo |
| 0 | Branch-Protection | branch protection not enabled on development/release branches |
| н/д | CI-Tests | no pull request found |
| 0 | CII-Best-Practices | no effort to earn an OpenSSF best practices badge detected |
| 0 | Code-Review | Found 0/30 approved changesets -- score normalized to 0 |
| 0 | Contributors | project has 0 contributing companies or organizations -- score normalized to 0 |
| 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 2 issue activity found in the last 90 days -- score normalized to 10 |
| 10 | Packaging | packaging workflow detected |
| 1 | Pinned-Dependencies | dependency not pinned by hash detected -- score normalized to 1 |
| 0 | SAST | no SAST tool detected |
| 4 | Security-Policy | security policy file detected |
| н/д | Signed-Releases | no releases found |
| 0 | Token-Permissions | detected GitHub workflow tokens with excessive permissions |
| 0 | Vulnerabilities | 29 existing vulnerabilities detected |
Прямі залежності 11
| Реєстр | Пакет | Обмеження версії | Маніфест |
|---|---|---|---|
| Go | github.com/gin-gonic/gin | v1.9.1 | backend/go.mod |
| Go | github.com/ledongthuc/pdf | v0.0.0-20250511090121-5959a4027728 | backend/go.mod |
| Go | github.com/stretchr/testify | v1.11.1 | backend/go.mod |
| Go | github.com/xuri/excelize/v2 | v2.10.1 | backend/go.mod |
| Go | modernc.org/sqlite | v1.51.0 | backend/go.mod |
| npm | lucide-react | ^0.468.0 | frontend/package.json |
| npm | mermaid | ^11.13.0 | frontend/package.json |
| npm | react | ^18.2.0 | frontend/package.json |
| npm | react-dom | ^18.2.0 | frontend/package.json |
| npm | react-markdown | ^10.1.0 | frontend/package.json |
| npm | remark-gfm | ^4.0.1 | frontend/package.json |
Усі залежності не зібрано
Не вдалося зібрати розв'язаний набір залежностей для цього звіту: GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository
Звіт у форматі JSON машиночитний
Зворотний зв’язок
Помітили щось хибне у цьому звіті або маєте чим поділитися? Неправильні вимірювання, непомічені інструменти, ідеї, запитання — усе доречно. Кожне повідомлення читається й отримує відповідь.
Оцінки — це сигнали, а не гарантії. Вони відображають публічно видимі практики на GitHub — це не аудит коду й не гарантія безпеки.
Відсутні дані виключаються, а ваги перенормовуються — нуль за відсутність ніколи не ставиться. Методологія версіонована й відкрита: метрики v2.10.0, схема v0.26.0 — повна методологія · вікі метрик.
Як окремий результат виглядає на тлі всього реєстру: сукупна статистика.