Las páginas sin traducir se abren en inglés y se indican como inglés.
Esta página es una traducción automática de la página en inglés, que prevalece. Machine-translated from the English page, which is authoritative.
Descripción general
Loom es un servidor que almacena memoria, documentos, conversaciones, un grafo de entidades y un índice de código para agentes de IA, como filas en ClickHouse, con Postgres como opción para el estado de memoria y conocimiento en vivo. Los agentes y las personas acceden a él mediante MCP, HTTP, los SDK de Python y TypeScript, y el panel. Tiene licencia Apache-2.0. Esta página te ayuda a decidir si encaja con tus necesidades.
Qué hace
- Memoria que perdura. Los hechos que un agente guarda siguen disponibles en sesiones posteriores y en otras herramientas, una afirmación por clave, con historial, procedencia y validez. Puede ser la memoria de una sola persona o estar compartida por muchos agentes y personas.
- Comprobaciones al escribir. Un duplicado casi idéntico se fusiona, una contradicción se marca y una escritura contra un hecho fijado se rechaza.
- Búsqueda que se abstiene.
memory.searchdevuelveabstain=truecon un código de motivo cuando ningún resultado supera un umbral calibrado para tu embedder. - Auditoría y borrado. Cada escritura que cambia la memoria deja una fila de auditoría con hash del contenido.
erasure.requesttermina con un censo de residuos sobre todas las tablas que usan las rutas de lectura. - Un índice de código con su historial. Búsqueda, símbolos, llamadores, impacto, historial de PR con comentarios de revisión y candidatos de bisect para tus repositorios, y cada respuesta indica el commit y el nivel del índice en que se basa. Con una fuente de seguimiento conectada, también el gestor de incidencias: comprobación de duplicados, vínculos incidencia↔PR y tests inestables.
La memoria y el índice de código son planos separados en un mismo servidor. Usa uno solo o ambos.
La memoria necesita un servidor y un token de escritor. El índice de código necesita además que se haya añadido un repositorio
(LOOM_CODE_REPOS_JSON, o Repositories → Add repository en el panel donde se ejecuta el
sandbox de trabajos de repositorio) y
LOOM_CODE_INGEST_ENABLED=true. Los plugins de Claude Code y Codex
usan ambos.
Dónde encajan los espacios de nombres
- Una org es el inquilino (tenant).
- Un espacio de nombres es la unidad de uso compartido y de acceso dentro de ella. Un despliegue suele tener
uno por equipo o proyecto, uno por cada bot que deba permanecer aislado, uno
personal-<slug>por persona (se crea en el primer uso y es el valor predeterminado para los clientes MCP de esa persona), y unocode-<repo>[-<branch>]por cada rama indexada. - Todos los miembros de un espacio de nombres leen todas las filas que contiene.
agentregistra quién escribió una fila; no es un límite.user_id/read_scope=own_usersepara a los usuarios finales dentro del espacio de nombres de un bot.- El acceso es un rol (viewer/writer/admin) sobre un espacio de nombres, que lleva un token o se añade mediante una concesión (grant).
Identidades y espacios de nombres contiene el modelo completo.
Cuándo encaja Loom
- Usas varias herramientas de IA y quieres que compartan lo que le dijiste a cualquiera de ellas, en un espacio de nombres personal.
- Varias herramientas y personas (Claude Code, Codex, Cursor, un bot de soporte, una persona en el panel) necesitan la misma memoria.
- Quieres SQL sobre lo que saben tus agentes: los hechos, las trazas, los costos y las filas de auditoría son tablas de ClickHouse.
- Ya ejecutas ClickHouse, o puedes hacerlo. Es el único almacén requerido de Loom; Postgres es una opción para la memoria activa y el estado del conocimiento.
- Es mejor una abstención o un conflicto señalado que una respuesta incorrecta pero segura.
- Necesitas historial, procedencia, auditoría o borrado verificable.
- Los agentes de programación necesitan un índice de tus repositorios.
Cuándo no encaja
| Situación | Por qué no | Alternativa |
|---|---|---|
| Un agente, un proceso, memoria de corta duración | Un servidor y una base de datos son sobrecarga cuando no se comparte nada | Una biblioteca de memoria dentro del proceso |
| Búsquedas por clave de menos de un milisegundo en una ruta crítica | Cada lectura es una consulta a la base de datos | Una caché delante de tu propio almacén |
| Analítica sobre el grafo completo o rutas largas | El recorrido es una consulta acotada por salto, con un máximo de cuatro saltos | Un almacén de grafos, alimentado con loom entity-export |
| Necesitas un framework de agentes | Loom no ejecuta el bucle del agente, los prompts ni el modelo | Un framework de agentes, con Loom como su memoria |
| Una garantía de cumplimiento normativo lista para usar | El borrado y la auditoría son primitivas de ingeniería | Tu proceso de cumplimiento, usando esas primitivas |
| Producción en ClickHouse OSS de un solo nodo sin plan de copias de seguridad | No hay replicación ni recuperación en un punto en el tiempo | ClickHouse Cloud |
| APIs congeladas | Las operaciones y los campos cambian entre versiones | Fija una versión; consulta ops.capabilities |
La validez es solo tiempo de validez (valid_at, valid_to); lo que Loom registró y cuándo
se guarda en el historial de versiones, no en un segundo eje temporal. Algunas partes requieren que un operador las
active: el índice de código, las fuentes de trackers, OAuth, la exportación de telemetría y el borrado en Langfuse,
ClickStack.
Lo que cuesta cada propiedad
| Propiedad | Mecanismo | Costo |
|---|---|---|
| Un solo motor (ClickHouse como autoridad) | Vectores, búsqueda léxica, grafo, filtros, auditoría y borrado son SQL sobre las mismas filas | Cada lectura es una consulta. Los lectores pagan FINAL en las filas versionadas. Las filas derivadas (entidades, resúmenes) llegan después, a través de workers. |
| Abstenerse en lugar de dar una coincidencia débil | Umbrales derivados al arrancar a partir de la distribución de los valores de similitud coseno del propio embedder (LOOM_ADAPTIVE_THRESHOLDS) |
Se rechazan algunas coincidencias débiles pero correctas; define min_similarity o floor_mode por solicitud. |
| Hechos que cambian | Veredictos de fusión, duplicado, conflicto y fijado en cada escritura; loom.memory_versions de solo anexado |
Cada escritura se compara con sus vecinos. Una paráfrasis puede esperar en la cola de revisión hasta que alguien la resuelva. |
| Ranking explicable | memory.search con explain=true detalla la puntuación de cada resultado; los resultados incluyen source_class y verified |
Por encima de top_k 15, donde explain está desactivado por defecto, explain=true hace que cada resultado sea más grande. |
| Compartir con control de acceso | La tupla de identidad en cada fila; los tokens y las concesiones llevan roles de espacio de nombres | Tú emites y rotas los tokens y concedes los roles. Una suite de fugas entre principals protege cada op de lectura en CI. |
| Borrado verificable | Una saga reanudable que termina en un censo de residuos; los backends externos fallan en modo cerrado | Un borrado es un trabajo de varios pasos. Un backend que no puede confirmar la eliminación deja la saga en failed para escalado manual. |
| Respuestas de código con frescura | Niveles de parser y compilador (SCIP); las respuestas incluyen as_of.commit y un indicador de obsolescencia |
Un repositorio grande tarda horas en indexarse. El nivel del compilador necesita la toolchain. |
Las afirmaciones de calidad te corresponde medirlas a ti. El repositorio incluye los arneses de benchmark y los resultados en bruto detrás de las cifras publicadas (resultados). Ejecuta los gates en tu despliegue con proveedores reales antes de confiar en un valor por defecto (ejecución).
Lista de verificación para decidir
Dos o más respuestas en la columna de la derecha significan que Loom probablemente no es la herramienta adecuada.
| Pregunta | Apunta a Loom | Apunta a otra opción |
|---|---|---|
| ¿Dos o más herramientas o agentes necesitan compartir memoria? | Sí | No, un solo proceso |
| ¿Puede ejecutar ClickHouse y operar un servicio? | Sí | No, prefiere un servicio gestionado |
| ¿Los datos deben permanecer en su propia infraestructura? | Sí | Sin preferencia |
| ¿Es mejor una abstención o un conflicto señalado que una respuesta incorrecta pero segura? | Sí | Siempre devolver algo |
| ¿Necesita historial, procedencia, auditoría o borrado verificable? | Sí | No |
| ¿Su ruta crítica es una búsqueda por clave en menos de un milisegundo? | No | Sí |
| ¿Necesita análisis de todo el grafo en lugar de unos pocos saltos? | No | Sí |
| ¿Puede asumir cambios de API entre versiones, o fijar una versión? | Sí | No |
| ¿Pagará por un embedder y un LLM reales, y hará benchmarks con sus datos? | Sí | No |
Requisitos previos
| Necesitas | Para |
|---|---|
| ClickHouse (OSS para evaluar, Cloud en producción) | Todo. Consulta los requisitos de ClickHouse. |
| Postgres 16+ (opcional) | Estado en vivo de la memoria y del conocimiento bajo la autoridad de memoria en Postgres, que se elige en el primer arranque de un despliegue; necesita un standby síncrono, salvo que LOOM_PG_DURABILITY=local (requisitos). |
| Docker con Compose 2.20 o posterior | El stack local publicado (instalador de una línea; en Windows, desde WSL 2) y la imagen del servidor. |
| Python 3.12+ | loom up solo para contribuidores, desarrollo del servidor y trabajo con la CLI de operador. |
| Un proveedor de embeddings | Recuperación real: OpenAI, Gemini o el embedder local en CPU que usa el stack publicado. |
| Un proveedor de LLM | Extracción, síntesis de memory.ask, code.ask: OpenAI o Anthropic. |
| Tokens y espacios de nombres | Acceso. Consulta tokens y permisos. |
| Para el índice de código | Acceso Git a los repositorios, LOOM_CODE_GITHUB_TOKEN para el historial de PR, y tiempo para el primer índice. |
Siguiente
Evaluar Loom distingue una prueba rápida del producto de una evaluación real de calidad. La guía de inicio rápido ejecuta el stack local. Despliegue explica cómo ejecutarlo para un equipo. El mapa de la documentación enumera todas las páginas en orden de lectura.