Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

kellmarks

Kellmarks es un panel de marcadores web local-first con Flask y JSON. Ofrece etiquetas jerárquicas, búsqueda booleana y API protegida sin bases de datos externas. Versión 02.00.03 soporta Python 3.10/3.13.

Ficha actualizada 27 sept 2026, 17:39 · upstream 27 sept 2026, 17:22 · release v02.00.03

Ver códigoProblemas y ayudaRepositorio ↗Sitio oficial
00

Qué es kellmarks

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

Kellmarks es un panel de marcadores web local-first desarrollado con Flask y persistencia en JSON único. Ofrece etiquetas jerárquicas mediante notación de barra, búsqueda booleana avanzada y capacidades de importación exportación validadas. La interfaz es un dashboard oscuro diseñado para privacidad local sin dependencias de bases de datos externas.

La arquitectura prioriza la seguridad con un modelo de confianza actualizado en la versión 02.00.00. El servidor por defecto se restringe a direcciones loopback, requiriendo autenticación bearer para accesos externos o internos si se configura. Los encabezados CORS y Trusted Host están habilitados estrictamente, rechazando comodines para proteger contra ataques de suplantación.

El despliegue requiere instalación manual mediante entorno virtual de Python 3.10 o superior. La persistencia utiliza archivos atómicos en docs/server/instance/, migrando datos desde esquemas antiguos si es necesario. Se recomienda usar un proxy inverso HTTPS para terminar TLS antes del servidor WSGI, evitando exponer tokens en redes no confiables.

CASOS DE USO
  • Gestión personal de marcadores web con privacidad local sin servidor central
  • Organización de enlaces mediante etiquetas jerárquicas profundas como cloud/aws/iam
  • Búsqueda avanzada de marcadores usando operadores booleanos y frases exactas
  • Consumo de la API JSON protegida para sincronización externa o dashboards
PUNTOS DESTACADOS
  • Arquitectura local-first con persistencia atómica en un único archivo JSON privado
  • Modelo de seguridad robusto con autenticación bearer, validación de hosts y CORS estrictos por defecto
  • Migración automática de datos desde esquemas antiguos (v01) a la nueva estructura v02
PRECAUCIONES
  • No incluye contenedores Docker ni scripts de orquestación nativos para despliegue rápido
  • Requiere configuración manual de entorno y tokens de autenticación para producción segura
  • La API está limitada a un único archivo JSON, lo que puede ser un cuello de botella en escalabilidad masiva
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU1 vCPUrecomendación inicial
MEMORIA1 GBRAM estimada
DISCO10 GBalmacenamiento base
COMPLEJIDADlownivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Despliegue manual

Desplegar detrás de un proxy inverso HTTPS (ej: Nginx) terminando TLS externamente. Configurar KELLMARKS_AUTH_TOKEN y KELLMARKS_REQUIRE_AUTH=1. No exponer el token en URLs ni logs. Usar servidor WSGI en red privada o contenedor aislado. Validar hosts confiables y evitar headers de reenvío no verificados. El modo estático usa docs/index.html sin API.

—Dockerfile
—Compose
—One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
Node.jsPython
SERVICIOS
No detectados
BASES DE DATOS
No detectadas
PUERTOS
8787
05

Puede sustituir a

Relaciones detectadas por el análisis del repositorio y su categoría.

06

Experiencia real de la comunidad

Ayuda a contrastar la estimación automática con instalaciones reales.

Todavía no hay datos comunitarios para este proyecto.