kolo docsbeta

Preguntas frecuentes

Respuestas cortas a preguntas habituales sobre Kolo, cada una con un enlace a la página que lo muestra. Lo que aún no está construido está en la Hoja de ruta.

En esta página

Estas respuestas cuentan lo que es cierto hoy en Kolo, cada una con un enlace a la página que lo muestra. Lo que aún no está construido está en la Hoja de ruta.

¿Kolo ya está en producción?

Todavía no. Todo Kolo es una beta (0.1): las bibliotecas y las apps de ejemplo se están probando, y la API todavía puede cambiar antes de la 1.0.0. La Hoja de ruta lista lo que no está construido y lo que necesita una 1.0.0.

¿Kolo es de código abierto?

Sí. Cada biblioteca de Kolo tiene la licencia MIT o Apache-2.0, a tu elección, en su propio repositorio. Los ejemplos de escritorio (Kolo Chat, Kolo Share, Kolo Meet y Kolo Board) y sus starters tienen solo la licencia Apache-2.0. Mira Código abierto en kolo.ciranda.dev.

¿Kolo funciona sin un servidor?

Los peers se conectan directamente entre sí, y ningún servidor nuestro está en el camino de tus datos. Para encontrarse por internet, los ejemplos usan nodos de entrada (bootstrap), que no transportan datos de la aplicación. Por defecto usan los dos nodos de entrada públicos que ejecuta Ciranda, incluidos en las bibliotecas, así que no hay nada que configurar. Puedes usar en su lugar tus propios nodos de entrada con -bootstrap, o dejarlo todo en un solo ordenador con -local en los ejemplos que lo tienen. Un relay es opcional y solo se usa cuando dos ordenadores no pueden conectarse directamente. Kolo Chat puede usar además un pin, que guarda una copia cifrada de los mensajes para quien está sin conexión. El pin es opcional: sin él, los mensajes solo llegan a quien está conectado. Kolo Share, Kolo Meet y Kolo Board no usan ninguno. Mira Ejecuta tu propia infraestructura y Hecho con Kolo.

¿Necesito ejecutar un servidor para usar Kolo?

No. Las bibliotecas y los ejemplos entran por defecto en la red pública, a través de dos nodos de entrada públicos que ejecuta Ciranda, gratis y sin garantía de disponibilidad mientras Kolo sea una beta. Dos personas en redes distintas se encuentran sin configurar nada. Solo ejecutas algo tú mismo si quieres tu propia red (un nodo de entrada con kolo-node run -first, usado con -bootstrap), o si personas detrás de un NAT estricto deben conectarse: eso necesita un relay, y lo ejecutas tú. Mira Ejecuta tu propia infraestructura.

¿Hay un relay o un pin públicos?

No. No hay ningún relay público ni ningún pin público, y Kolo nunca usa uno por defecto. Lo que sí ejecuta Ciranda son dos nodos de entrada públicos (bootstrap), que las bibliotecas y los ejemplos usan por defecto, gratis y sin garantía de disponibilidad mientras Kolo sea una beta. Sus direcciones están incluidas en la biblioteca (kolodht.PublicServers). Para usar tus propios nodos de entrada, pasa -bootstrap; en una biblioteca, pasa tu propia lista a Bootstrap, y una lista vacía que no es nil se rechaza, de modo que una red privada nunca entra por error en la pública. Los comandos de un relay, un pin y tus propios nodos de entrada están en Ejecuta tu propia infraestructura.

¿Qué puede ver quien opera un relay?

Los dos peers abren su propia conexión cifrada a través del relay, así que el relay copia bytes que no puede leer. En palabras del README de kolo-relay:

Lo que el relay llega a saber: las dos claves de cada sesión, las direcciones de los dos clientes, qué claves tienen reservas, cuándo empiezan y terminan las sesiones, y el tamaño y el ritmo de los paquetes internos. No puede leerlos ni cambiarlos, y siempre puede descartarlos, retrasarlos o cortarlos.

Mira kolo-relay y Relay.

¿Un pin puede leer mis mensajes?

No. Un pin guarda texto cifrado sin las claves: almacena y sirve registros firmados, textos cifrados y marcas de borrado, y nunca recibe las claves de las entradas. Aun así ve qué claves de propietario e IDs de log aloja, su tamaño, cuándo crecen, y la clave, la dirección y el momento de cada petición. Mira kolo-pin.

¿Por qué Kolo usa solo IPv4?

A propósito: las bibliotecas usan solo IPv4, y cualquier forma de IPv6, incluida la IPv4 mapeada, se rechaza. El soporte de IPv6 es un elemento Futuro en la Hoja de ruta, sin plan ni fecha. Mira kolo-node y kolo-swarm para ver dónde se comprueban las direcciones.

¿Quitar a un miembro le quita el acceso?

No. En Kolo Chat, un admin puede quitar a un miembro de la lista de miembros, y las demás copias dejan de hablar con él cuando se enteran. El miembro quitado conserva la clave de la conversación, así que aún puede leer los mensajes nuevos desde los pins, hasta que el chat tenga una rotación de claves, que hoy no tiene (está En exploración en la Hoja de ruta). Mira Paso 7: Acordar miembros y salas con kolo-braid y las claves derivadas de kolo-log.

¿Puedo usar una cuenta en varios dispositivos?

En los ejemplos, todavía no. Kolo no tiene cuentas: una identidad es una clave de kolo-id, y en los ejemplos un kolo-id vive en un solo dispositivo. Las bibliotecas tienen las piezas: kolo-id tiene una frase de recuperación de 24 palabras y certificados de dispositivo firmados por la clave de la persona, kolo-invite vincula un dispositivo nuevo por invitación, y el paquete devices de kolo-braid guarda los dispositivos de una persona en un grupo. Ningún ejemplo las usa todavía; eso está En exploración en la Hoja de ruta. Nunca copies la carpeta de datos de un ejemplo a un segundo dispositivo.

¿Por qué el chat de ejemplo no pone los mensajes en el braid?

Los mensajes no necesitan un orden acordado: cada miembro escribe su propio log, y dos mensajes escritos en el mismo momento pueden mostrarse en cualquier orden. La lista de miembros y la de salas son estado compartido con el que todos los miembros tienen que terminar igual, así que solo esas van a un braid. Mira Paso 7: Acordar miembros y salas con kolo-braid.

¿Kolo funciona en móviles o por Bluetooth?

Todavía no. Los ejemplos para móviles y una biblioteca de Bluetooth LE están en la Hoja de ruta como En exploración, sin empezar. Hoy los ejemplos funcionan en macOS, Windows y Linux.

¿Hay un servidor MCP de la documentación?

Todavía no: está en la Hoja de ruta como En exploración. Hoy cada página de esta documentación tiene una versión en Markdown en inglés, español y portugués, y el sitio publica llms.txt y llms-full.txt para cada idioma, como /es/llms.txt.

¿Cómo lo pruebo en dos ordenadores?

Arranca cada ejemplo sin flags: las dos entran en la red pública, así que dos ordenadores en redes distintas se encuentran. Para tu propia red, ejecuta un nodo de entrada en un ordenador al que lleguen los dos y arranca cada ejemplo con -bootstrap apuntando a él; para quedarte en un solo ordenador, usa -local. Añade un relay con -relay cuando los dos ordenadores no puedan conectarse directamente. Los comandos están en Ejecuta tu propia infraestructura, y el README de cada ejemplo tiene una sección Try it con un comando por bloque para dos ordenadores: los repositorios están enlazados desde Hecho con Kolo.