Informe de salud del softwareesquema 0.34.0 · métricas 2.10.0 · 2026-10-04 12:31 UTC

lyonzin / knowledge-rag

Local RAG MCP server for Claude Code — hybrid search (semantic + BM25), cross-encoder reranking, 13 MCP tools, 20 format parsers. Zero external servers, zero API keys.

PythonMIT★ 290 estrellas⑂ 42 forksdesde feb 2026Ver en GitHub ↗

TipoHerramienta de línea de comandosBibliotecaServidor MCPcómo se determina

lyonzin/knowledge-rag tiene un índice de salud de 87 sobre 100, lo que lo sitúa en la banda Excelente. Su puntuación más alta es Engineering Quality (94/100) y la más baja, Sustainability & Governance (55/100). Se actualizó por última vez hoy. Una sola persona concentra la mayor parte del trabajo reciente.

global / 100

Excelente

Índice de salud del software

Las métricas se agrupan en categorías ponderadas sobre una escala estandarizada de 1 a 100. El resultado global parte de su media ponderada, calibrada contra la distribución del registro público para que las bandas tengan significado percentil; cuando la evidencia pública activa la Política de Jurisdicciones de Alto Riesgo, la calificación se ajusta y recibe un límite «En riesgo» de 34.

Excepcional93-100El nivel más alto del registro (≈ el 5% superior); cumple prácticamente todos los criterios evaluados

Excelente80-92Sólido en todos los frentes; carencias menores

Bueno65-79Saludable; carencias limitadas y manejables

Moderado50-64Aceptable con carencias notables; se recomienda revisión

Débil35-49Debilidades sustanciales en varias áreas

En riesgo20-34Debilidades significativas; su adopción exige cautela

Crítico1-19Problemas graves (proyecto abandonado, un solo mantenedor, sin higiene)

Perfil de puntuación

Cada eje es una categoría. La forma importa más que la media: un proyecto sano llena toda la figura, mientras que un perfil de picos y cráteres indica que la fortaleza en una dimensión enmascara el riesgo en otra.

El resultado global ponderado 73 se calibra a 87 en la escala publicada del índice (calibración del registro 2026-08-02).

Titularidad

Lyon.Cuenta personal

6 seguidores39 repositorios públicosdesde mar 2019HARDWAY

Este repositorio pertenece a una cuenta personal. Un proyecto con un único propietario conlleva más riesgo de continuidad que uno respaldado por una organización.

Ecosistemas de paquetes

Registro	Paquete	Versión	Descargas / mes	Versiones	Última publicación	Etiquetas
PyPI	knowledge-rag	4.10.0	2343	47	hace 0 días	bm25 chromadb claude-code embeddings fastembed hybrid-search knowledge-base local-ai mcp rag reranking retrieval-augmented-generation semantic-search
npm	knowledge-rag	4.9.0	451	22	hace 11 días	rag mcp claude-code semantic-search embeddings knowledge-base local-ai retrieval-augmented-generation hybrid-search claude

Métricas por categoría

Vitalidad

¿Está vivo el proyecto: se escribe código y se publican versiones?

90Excelente · 21% del índice global

Actividad de desarrollo

83Excelente

Cómo se puntúa

36/36	Recencia de push — último push hace 0 días
18.7/36	Cadencia de commits — 27/52 semanas con commits
18/18	Volumen de commits — 250 commits en el último año
10/10	OpenSSF Scorecard: Maintained — 30 commit(s) and 14 issue activity found in the last 90 days -- score normalized to 10

Datos de entrada utilizados

commits_last_year	250
human_commit_share	0,76
days_since_last_push	0
active_weeks_last_year	27

Disciplina de publicación

100Excepcional

Cómo se puntúa

27/27	Publica versiones — 19 versiones publicadas
36/36	Recencia de las versiones — última versión hace 0 días
27/27	Cadencia de publicación — una versión cada ~7,1 días
0/10	OpenSSF Scorecard: Signed-Releases — sin datos

Datos de entrada utilizados

releases_count	19
latest_release_tag	v4.10.0
releases_from_tags	no
days_since_latest_release	0
mean_days_between_releases	7,1

Excluidos de la puntuación (sin datos o no aplicable): OpenSSF Scorecard: Signed-Releases. Los pesos restantes se han renormalizado.

Comunidad y Adopción

¿Tiene el proyecto usuarios, descargas, atención y unas condiciones acogedoras para quienes contribuyen?

68Bueno · 17% del índice global

Popularidad y adopción

53Moderado

Cómo se puntúa

39.9/60	Estrellas — 290 estrellas
13.4/25	Forks — 42 forks
0/15	Observadores — 1 observadores

Datos de entrada utilizados

forks	42
stars	290
watchers	1
growth_state	unverified
growth_factor_pct	100
growth_unverified_reason	no_history

Salud de la comunidad

92Excelente

Cómo se puntúa

22.5/22.5	README
22.5/22.5	Licencia — licencia reconocida (MIT)
18/18	Guía CONTRIBUTING
13.5/13.5	Código de conducta
0/7.2	Plantilla de issues
6.3/6.3	Plantilla de PR

Datos de entrada utilizados

has_readme	sí
has_license	sí
readme_badges	10
has_contributing	sí
has_issue_template	no
has_code_of_conduct	sí
readme_badge_services	bestpractices.coreinfrastructure.org, github.com, shields.io
has_pull_request_template	sí

Adopción en el ecosistema (descargas)

58Moderado

Cómo se puntúa

46/80	Descargas mensuales — 2794 descargas/mes en npm, pypi
0/20	Dependientes en el registro — no lo informa este ecosistema

Datos de entrada utilizados

packages	knowledge-rag, knowledge-rag
dependents	—
ecosystems	npm, pypi
total_downloads	—
monthly_downloads	2794
unverified_packages_excluded	—

Excluidos de la puntuación (sin datos o no aplicable): Dependientes en el registro. Los pesos restantes se han renormalizado.

Sostenibilidad y Gobernanza

¿Sobrevivirá el proyecto a sus personas: factor bus, capacidad de respuesta, quién lo respalda y mantenimiento del paquete?

55Moderado · 23% del índice global

Resiliencia de mantenedores (factor bus)

23En riesgo

Cómo se puntúa

9/54	Factor bus — la mitad de los commits recae en 1 contribuyente(s)
1/22.5	Distribución de commits — el principal contribuyente firma el 96% de los commits
6.8/13.5	Amplitud de contribuyentes — 5 contribuyentes
6/10	OpenSSF Scorecard: Contributors — project has 2 contributing companies or organizations -- score normalized to 6

Datos de entrada utilizados

bus_factor	1
contributors_sampled	5
top_contributor_share	0,957

Capacidad de respuesta a issues y PR

63Moderado

Cómo se puntúa

42/42	Resolución de issues — 100% de issues cerradas
19.8/30	Aceptación de PR — 122/185 PR decididos fusionados
0/13	Newcomer PR acceptance — 0/1 PR de contribuyentes primerizos fusionados en 30 d
1.5/15	OpenSSF Scorecard: Code-Review — Found 4/26 approved changesets -- score normalized to 1

Datos de entrada utilizados

merged_prs	122
open_issues	0
closed_issues	45
prs_merged_7d	6
prs_decided_7d	8
prs_merged_30d	7
prs_decided_30d	9
issue_closed_ratio	1
closed_unmerged_prs	63
first_time_authors_30d	1
first_time_prs_merged_30d	0
first_time_prs_decided_30d	1

Propiedad y custodia

50Moderado

Cómo se puntúa

10/30	Respaldo de la propiedad — cuenta personal (usuario)
0/20	Dominio verificado — no aplicable a cuentas de usuario
6.1/25	Alcance del propietario — 6 seguidores de lyonzin
23.7/25	Trayectoria — 39 repos públicos, cuenta de ~7 años

Datos de entrada utilizados

followers	6
owner_type	User
is_verified	—
owner_login	lyonzin
public_repos	39
account_age_days	2757

Excluidos de la puntuación (sin datos o no aplicable): Dominio verificado. Los pesos restantes se han renormalizado.

Mantenimiento de paquetes

100Excepcional

Cómo se puntúa

25/25	Publicado y resoluble — 2 paquete(s) en npm, pypi
35/35	Recencia de publicación — última publicación hace 0 días
20/20	Historial de versiones — 47 versiones en el registro
20/20	No obsoleto — activo, ni obsoleto ni retirado

Datos de entrada utilizados

packages	knowledge-rag, knowledge-rag
ecosystems	npm, pypi
any_deprecated	no
min_days_since_publish	0

Calidad de Ingeniería

¿Existen unas prácticas mínimas de ingeniería y documentación?

94Excepcional · 19% del índice global

Prácticas de ingeniería

90Excelente

Cómo se puntúa

24/24	Flujos de trabajo de CI — 7 flujo(s) de trabajo
24/24	Pruebas presentes
16/16	Configuración de linter — pyproject.toml ([tool.ruff])
9.6/9.6	Hooks de pre-commit
0/6.4	.editorconfig
16/20	OpenSSF Scorecard: CI-Tests — 25 out of 30 merged PRs checked by a CI test -- score normalized to 8

Datos de entrada utilizados

has_ci	sí
has_tests	sí
has_editorconfig	no
has_linter_config	sí
has_precommit_config	sí

Documentación

100Excepcional

Cómo se puntúa

30/30	README
25/25	Directorio de documentación
15/15	Sitio de documentación / página del proyecto — https://pypi.org/project/knowledge-rag/
10/10	Descripción del repositorio
10/10	Topics — 20 topics
10/10	Wiki

Datos de entrada utilizados

topics	claude, claude-code, local-ai, mcp, rag, retrieval-augmented-generation, semantic-search, vector-database, knowledge-base, reranking, document-search, hybrid-search, mcp-server, antigravity, claude-code-cli, codex, cursor-ai, inteligencia-artificial, rag-chatbot, rag-pipeline
has_wiki	sí
homepage	https://pypi.org/project/knowledge-rag/
docs_site	https://pypi.org/project/knowledge-rag/
has_readme	sí
has_docs_dir	sí
has_description	sí

Seguridad

¿Son sólidas las prácticas visibles de seguridad y de cadena de suministro, sin exposición jurisdiccional de alto riesgo sin resolver?

61Moderado · 16% del índice global

Postura de seguridad

61Moderado

Cómo se puntúa

7.5/7.5	Binary-Artifacts — no binaries found in the repo
2.2/7.5	Branch-Protection — branch protection is not maximal on development and all release branches
2/2.5	CI-Tests — 25 out of 30 merged PRs checked by a CI test -- score normalized to 8
1.2/2.5	CII-Best-Practices — badge detected: Passing
0.8/7.5	Code-Review — Found 4/26 approved changesets -- score normalized to 1
1.5/2.5	Contributors — project has 2 contributing companies or organizations -- score normalized to 6
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	Licencia — license file detected
7.5/7.5	Maintained — 30 commit(s) and 14 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
3.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 — sin datos
0/7.5	Token-Permissions — detected GitHub workflow tokens with excessive permissions
3/7.5	Vulnerabilities — 6 existing vulnerabilities detected

Datos de entrada utilizados

source	openssf_scorecard
checks_evaluated	17
scorecard_version	v5.5.0
checks_inconclusive	1
scorecard_aggregate	6,1

Excluidos de la puntuación (sin datos o no aplicable): Signed-Releases. Los pesos restantes se han renormalizado.

Preparación para IA

¿Hasta qué punto está el repositorio preparado para desarrollarse y mantenerse con agentes de codificación de IA? Tiene un peso deliberadamente pequeño (4%): las herramientas para agentes son una señal real de mantenimiento, pero un repositorio sin ninguna puede alcanzar igualmente 100/100.

63Moderado · 4% del índice global

Contexto y guía para agentes

40Débil

Cómo se puntúa

0/45	Instrucciones para agentes — sin CLAUDE.md / AGENTS.md / reglas de editor
0/15	Documentación legible por máquinas (llms.txt)
40/40	Historial de commits legible — 76 de 76 commits humanos declaran su intención (asunto estructurado o cuerpo explicativo)

Datos de entrada utilizados

has_llms_txt	no
llms_txt_url	—
legible_history_share	1
agent_instruction_files	—
agent_instruction_max_bytes	—

Bucle de verificación (compilación / pruebas / verificación de tipos)

69Bueno

Cómo se puntúa

18/18	Arranque con un solo comando — tests/fixtures/formats/Makefile
22/22	Pruebas automatizadas
11/11	Configuración de lint / formato — pyproject.toml ([tool.ruff])
0/11	Verificación estática de tipos
10/10	Entorno reproducible — Dockerfile
0/10	Práctica demostrada con agentes — ningún commit con autoría de agente entre los últimos 100
8/8	Mantenimiento automatizado — 7 de los últimos 100 commits son actualizaciones automáticas de dependencias
0/10	OpenSSF Scorecard: Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0

Datos de entrada utilizados

has_nix	no
has_tests	sí
lockfiles	—
has_dockerfile	sí
typed_language	no
bootstrap_files	tests/fixtures/formats/Makefile
has_devcontainer	no
has_linter_config	sí
typecheck_configs	—
agent_commit_share	0
toolchain_manifests	—
dependency_bot_commit_share	0,07

Legibilidad del código para modelos

55Moderado

Cómo se puntúa

0/45	Código verificable por tipos — Python sin configuración de verificación de tipos
54.6/55	Tamaños de archivo manejables — 1/148 archivos fuente de más de 60 KB

Datos de entrada utilizados

primary_language	Python
largest_source_bytes	241.842
source_files_sampled	148
oversized_source_files	1

Interfaces legibles por máquina

100Excepcional

Cómo se puntúa

40/40	Esquema de API (OpenAPI/GraphQL/proto) — tests/fixtures/formats/sample.proto
20/20	Servidor MCP
40/40	Ejemplos ejecutables — examples, notebooks

Datos de entrada utilizados

example_dirs	examples, notebooks
has_mcp_signal	sí
api_schema_files	tests/fixtures/formats/sample.proto
interfaces_expected_of	—

Datos clave

290estrellas de GitHub

5contribuidores

250commits en los últimos 12 meses

0días desde el último push

19versiones publicadas

1factor bus

0issues abiertas

npm, PyPIecosistemas de paquetes

Advertencias de recopilación de datos

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

Más detalle

Historial de estrellas y forks 0 ★ / 42 ⇿

0Estrellas

42Forks

18Versiones

Cuándo se añadió cada estrella y fork, recopilado de GitHub y agrupado por día. El crecimiento acumulado se sitúa justo encima de las adiciones diarias que lo componen, de modo que ambos se leen en conjunto: la acumulación orgánica sostenida no se parece en nada a un pico abrupto y efímero. Cuando esa diferencia es medible, se informa como autenticidad del crecimiento.

Mayor 1Menor 8Parche 9

OpenSSF Scorecard 6.1 / 10

6.1agregado

Evaluación de seguridad independiente y agnóstica en cuanto a herramientas, procedente del proyecto de código abierto OpenSSF Scorecard. Cada comprobación premia una práctica de seguridad, no la herramienta de un proveedor concreto. Las comprobaciones que Scorecard no pudo determinar se marcan como n/d y se excluyen de la puntuación de seguridad (nunca se cuentan como cero).Scorecard v5.5.0 · 2026-10-04 12:31 UTC

10	Binary-Artifacts	no binaries found in the repo
3	Branch-Protection	branch protection is not maximal on development and all release branches
8	CI-Tests	25 out of 30 merged PRs checked by a CI test -- score normalized to 8
5	CII-Best-Practices	badge detected: Passing
1	Code-Review	Found 4/26 approved changesets -- score normalized to 1
6	Contributors	project has 2 contributing companies or organizations -- score normalized to 6
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	30 commit(s) and 14 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
7	SAST	SAST tool detected but not run on all commits
10	Security-Policy	security policy file detected
n/d	Signed-Releases	no releases found
0	Token-Permissions	detected GitHub workflow tokens with excessive permissions
4	Vulnerabilities	6 existing vulnerabilities detected

Dependencias directas 12

Registro	Paquete	Restricción de versión	Manifiesto
PyPI	chromadb	`>=1.4.0`	pyproject.toml
PyPI	pymupdf	`>=1.23.0`	pyproject.toml
PyPI	fastembed	`>=0.4.0`	pyproject.toml
PyPI	mcp	`>=2.0.0,<3.0.0`	pyproject.toml
PyPI	numpy	`>=1.24.0`	pyproject.toml
PyPI	requests	`>=2.33.0`	pyproject.toml
PyPI	beautifulsoup4	`>=4.12.0`	pyproject.toml
PyPI	python-docx	`>=1.0.0`	pyproject.toml
PyPI	openpyxl	`>=3.1.0`	pyproject.toml
PyPI	python-pptx	`>=1.0.0`	pyproject.toml
PyPI	watchdog	`>=4.0.0`	pyproject.toml
PyPI	pyyaml	`>=6.0`	pyproject.toml

Todas las dependencias 35

Conjunto completo de dependencias resueltas según el grafo de dependencias de GitHub: 12 paquetes directos y 23 indirectos (transitivos). El cierre transitivo es completo cuando el repositorio incluye un lockfile.

Registro	Paquete	Versión	Relación
PyPI	beautifulsoup4	`—`	directa
PyPI	chromadb	`—`	directa
PyPI	fastembed	`—`	directa
PyPI	mcp	`—`	directa
PyPI	numpy	`—`	directa
PyPI	openpyxl	`—`	directa
PyPI	pymupdf	`—`	directa
PyPI	python-docx	`—`	directa
PyPI	python-pptx	`—`	directa
PyPI	pyyaml	`—`	directa
PyPI	requests	`—`	directa
PyPI	watchdog	`—`	directa
PyPI	bandit	`—`	indirecta
PyPI	hatchling	`—`	indirecta
PyPI	hypothesis	`—`	indirecta
PyPI	interrogate	`—`	indirecta
PyPI	mutmut	`—`	indirecta
PyPI	mypy	`—`	indirecta
PyPI	nvidia-cublas-cu12	`—`	indirecta
PyPI	nvidia-cuda-runtime-cu12	`—`	indirecta
PyPI	nvidia-cudnn-cu12	`—`	indirecta
PyPI	onnxruntime-gpu	`—`	indirecta
PyPI	pip-audit	`—`	indirecta
PyPI	pre-commit	`—`	indirecta
PyPI	psutil	`—`	indirecta
PyPI	pytest	`—`	indirecta
PyPI	pytest-benchmark	`—`	indirecta
PyPI	pytest-cov	`—`	indirecta
PyPI	pytest-memray	`—`	indirecta
PyPI	pytest-rerunfailures	`—`	indirecta
PyPI	pytest-timeout	`—`	indirecta
PyPI	radon	`—`	indirecta
PyPI	ruff	`—`	indirecta
PyPI	uvicorn	`—`	indirecta
PyPI	vulture	`—`	indirecta

Avisos de dependencias sin evaluar

El cotejo de avisos no pudo ejecutarse para este informe: No resolved dependencies carried a version and a supported ecosystem

Informe JSON sin procesar legible por máquina

Comentarios

¿Algo no cuadra en este informe, o hay ideas que compartir? Mediciones erróneas, herramientas no detectadas, ideas, preguntas: todo es bienvenido. Cada mensaje se lee y recibe respuesta.

Las puntuaciones son señales, no garantías. Reflejan prácticas públicamente visibles en GitHub; no son una auditoría de código ni una garantía de seguridad.

Los datos ausentes se excluyen y los pesos se renormalizan; nunca se puntúan como cero. La metodología es versionada y abierta: métricas v2.10.0, esquema v0.34.0 — metodología completa · wiki de métricas.

Cómo se sitúa un resultado dentro del registro general: estadísticas agregadas — PyPI, npm.

Índice de salud del software

Perfil de puntuación

Titularidad

Ecosistemas de paquetes

Métricas por categoría

Datos clave

Advertencias de recopilación de datos

Más detalle

Comentarios

Registros relacionados