Cindy agente de IA de código abierto: instalar, API local y límites

Cindy agente de IA de código abierto: instalación según el README, API local, registros de diagnóstico, telemetría y límites de un repositorio joven.
Cindy agent IA open source : installer, API locale, limites

Cindy agente de IA de código abierto: el repositorio makecindy/cindy se presenta como «el agente de IA de código abierto que funciona listo para usar». Según el README, es un cliente que se ejecuta en tu máquina, con tus archivos y tus aplicaciones con sesión iniciada, y que maneja agentes ya existentes (hoy Claude Code y Codex). El repositorio tenía unas 6300 estrellas a finales de octubre de 2026.

Para un equipo de operaciones, la pregunta útil no es la promesa, sino el alcance: qué se ejecuta en local, qué viaja a un servicio alojado y qué se puede medir. Este artículo sigue el README y los documentos de la carpeta docs/. Para el marco general, consulta supervisar un agente de código en la empresa.

Aviso de honestidad: span.observer no ha instalado Cindy. Los comandos vienen del README y de la documentación del repositorio, y las capturas reproducen su texto. El repositorio es reciente y su respaldo exige cautela, como se detalla más abajo.

Cindy agente de IA de código abierto: qué dice el repositorio

  • Licencia: Apache-2.0. El archivo LICENSE contiene el texto estándar de la licencia, sin línea de copyright con nombre. El README añade que los pesos de modelos, conjuntos de datos, prompts, marcas y componentes de terceros pueden tener sus propias condiciones.
  • Cifras leídas el 26 de octubre de 2026: unas 6300 estrellas, 774 forks, unas 1700 incidencias abiertas y 10 286 commits en main. La versión marcada «Latest» es la v0.1.115 (23 de octubre); una preversión v0.1.117-beta es del 26 de octubre.
  • Contenido: un monorepo pnpm con apps/desktop (aplicación Electron), apps/mobile (Expo / React Native), packages/* (autenticación, vinculación de dispositivos, orquestación de agentes, proveedores de modelos) y apps/*-bin (binarios de herramientas descargados por plataforma).
  • Idea: puedes cambiar de modelo a mitad de tarea sin perder el espacio de trabajo, la memoria, las habilidades ni las herramientas. El README añade que el agente puede controlar un navegador, un ordenador y un teléfono, y recibir trabajo desde mensajería o agendas.
  • Servicio: el backend vive en otro repositorio. Por defecto, el cliente se conecta a los servicios en la nube oficiales de Cindy.

Visita al repositorio: puesta en marcha y API local

El repositorio no publica una captura utilizable de la interfaz: su banner es un visual de marca, que no reutilizamos. Las dos imágenes siguientes reproducen por tanto contenido real del repositorio, renderizado como texto: los comandos del README y los puntos de entrada de la API local descrita en docs/local-agent-api.md.

Comandos del README de Cindy: git clone, git lfs pull, pnpm install y luego pnpm restart:desktop:remote con la opción --region=cn o --region=global
Source : github.com

Instalación paso a paso

Paso 1: requisitos

El README pide Node.js 22.x, pnpm 10.x y Git LFS. Describe un cliente de escritorio Electron; macOS no se nombra de forma explícita, pero el repositorio menciona el empaquetado para Windows y una guía para Linux.

Paso 2: clonar e instalar dependencias

git clone https://github.com/makecindy/cindy.git
cd cindy
git lfs pull
pnpm install

Paso 3: ejecutar el cliente de escritorio en desarrollo

# Mainland China Cindy account
pnpm restart:desktop:remote --region=cn

# Global Cindy account
pnpm restart:desktop:remote --region=global

El README indica que «Skip Sign-In» ejecuta agentes locales sin cuenta, pero entonces no están disponibles las funciones que dependen del servidor. También puedes conectar una suscripción existente de Claude Code o Codex, tus propias claves de API o modelos locales.

Paso 4: Linux (Ubuntu, Arch, Omarchy)

docs/linux.md describe Ubuntu 22.04 y 24.04 mediante el paquete .deb oficial. Para Arch y Omarchy lista primero las dependencias:

sudo pacman -Syu --needed curl jq libarchive coreutils util-linux findutils procps-ng \
  gtk3 nss alsa-lib libxss libxtst libnotify libdrm mesa \
  gnome-keyring libsecret desktop-file-utils xdg-utils

Después pide cerrar Cindy y ejecutar, sin sudo, el comando de la página de descarga, por ejemplo curl -fsSL https://hotfix.cindy.app/cindy/install-omarchy.sh | bash. El documento indica que ese script está «pendiente de publicación en el sitio web». Como con cualquier comando curl | bash, lee el script antes de ejecutarlo. Alpine (musl) y las sesiones de escritorio root no son compatibles; hace falta un llavero Secret Service desbloqueado y el sandbox de espacio de nombres de usuario de Electron.

La API local: el punto a vigilar

Extracto de docs/local-agent-api.md de Cindy: petición POST a 127.0.0.1 con cabecera Bearer, archivo discovery.json y lista de métodos capabilities, models, session/open, send, steer, interrupt, events, tool/reply, session/close
Source : github.com

Según docs/local-agent-api.md, las aplicaciones del mismo ordenador pueden iniciar sesiones de agente mediante un RPC HTTP en el bucle local: POST http://127.0.0.1:<port>/rpc. El puerto es aleatorio y está ligado a 127.0.0.1; toda petición con cabecera Origin se rechaza, así que un navegador no puede llamarla. Cada aplicación pide su propia autorización, que el usuario aprueba en un cuadro de Cindy y puede revocar una a una. El documento aclara que no es un punto de acceso compatible con OpenAI ni con Anthropic.

  • Tokens: se guardan en la memoria del proceso, nunca en claro; el archivo de autorizaciones solo conserva hashes.
  • Política de herramientas: client-only o native. En modo native, el agente se ejecuta con los permisos del sistema del usuario y el directorio de trabajo no es un sandbox.
  • Límites indicados: 16 sesiones simultáneas, 32 autorizaciones, 8 solicitudes pendientes y 16 MiB por petición.

Observar Cindy

El README no menciona OpenTelemetry ni exportación de métricas. Lo que los documentos permiten seguir:

  • Registros locales: docs/working-directory-diagnostics.md describe registros de diagnóstico del directorio de trabajo, a nivel info, con el ámbito workdir-diagnostics y campos de correlación (sessionRef, directoryRef, requestId, exitCode). Los identificadores son hashes con clave que cambian en cada reinicio, por lo que no revelan rutas. El documento aconseja localizar la comprobación bloqueada por hora y enlazar los registros mediante sessionRef.
  • Envío de registros: el cliente tiene una entrada de envío; el ámbito workdir-diagnostics está autorizado para el envío porque solo contiene nombres de evento fijos, códigos de error, números e identificadores anónimos.
  • Telemetría: las compilaciones oficiales incluyen TapDB para estadísticas de uso agregadas; un cliente con sesión iniciada envía un latido en línea (ID de cuenta, plataforma, versión). Los volcados de fallos se quedan en la máquina. Una compilación desde el código fuente puede quitar la analítica.
  • Agentes subyacentes: las trazas y los costes vienen de Claude Code o de Codex. Consulta observar agentes MCP con OpenTelemetry y el coste de un agente de IA en tokens.

Límites y puntos abiertos

  • Respaldo que matizar: no pudimos leer la fecha de creación del repositorio. Las primeras versiones visibles son de finales de julio de 2026 (la página no muestra el año; las etiquetas de versión indican 2026). Para unos tres meses de existencia, el repositorio ya muestra más de 10 000 commits, más de 7000 pull requests numeradas y 1700 incidencias abiertas: el historial probablemente viene de un desarrollo interno anterior. Las estrellas no prueban ni madurez ni seguridad.
  • Números de versión: las versiones 0.1.x y las preversiones frecuentes (casi una al día en octubre) indican un producto que cambia rápido.
  • Repositorio parcial: el servidor está en otro repositorio; sin cuenta faltan funciones.
  • Licencia del código, no de las marcas: Apache-2.0 cubre el código; marcas, prompts y conjuntos de datos pueden tener otras condiciones.
  • Permisos amplios: el agente actúa sobre tus archivos, tu navegador e incluso tu teléfono. Pruébalo en un equipo sin secretos.
  • Documentación desigual: algunos documentos son planes o notas de trabajo, y al menos uno está escrito en chino.
  • Para comparar con otro controlador de agentes, consulta T3 Code.

Buenas prácticas

  • Instala primero en una máquina o un perfil desechable, sin claves ni carpetas sensibles.
  • Lee cualquier script curl | bash y comprueba el hash SHA-256 en la instalación manual.
  • Mantén la API local en modo client-only cuando la aplicación cliente no necesite herramientas nativas.
  • Decide antes del uso si la analítica y el latido son aceptables, o compila desde el código fuente.
  • Registra las decisiones de aprobación sin buscar culpables: el objetivo es un flujo más fiable.

Preguntas frecuentes

¿Cindy sustituye a Claude Code o a Codex?

No. Según el README, Cindy combina harnesses existentes (hoy Claude Code y Codex) con modelos y herramientas; se anuncia un harness nativo para más adelante.

¿Es gratuito y realmente de código abierto?

El README dice que el cliente es gratuito y está bajo Apache-2.0, y el archivo LICENSE es el texto estándar de esa licencia. El servidor está en otro repositorio, y tus suscripciones o claves de modelos corren por tu cuenta.

¿Se puede usar sin cuenta?

Sí, con «Skip Sign-In»: funcionan agentes locales, pero no están disponibles las funciones que dependen del servidor.

Conclusión

Cindy es un cliente de agente de IA ambicioso, bajo Apache-2.0, con una API local acotada y registros de diagnóstico documentados. Es joven, cambia rápido y su respaldo debe confirmarse: pruébalo lejos de tus secretos antes de adoptarlo. Fuente: repositorio makecindy/cindy.

span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Dynatrace es una marca de Dynatrace LLC. Comprueba siempre los valores (puertos, versiones, tamaños) en la documentación oficial correspondiente a tu versión.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
OpenBot espace de travail agents IA : installer et limites

OpenBot espacio de trabajo agentes IA: instalar y límites

Next Post
KEDA autoscaling Kubernetes : échelle sur événements

KEDA autoescalado Kubernetes: escala por eventos

Related Posts