La película
Unos 7 minutos, narrados, para cualquier persona: qué es Verse, qué es un agente y cómo la plataforma mantiene a los agentes bajo control. Con subtítulos y capítulos.
Leer la narración cada palabra de la película
1Conoce a Verse
Esto es Verse. Vive en tu escritorio como un cristal luminoso. Le hablas con la voz o escribiendo, y responde con una voz propia.
Pero Verse no trabaja por su cuenta. Cuando le pides trabajo de verdad, entrega la tarea a un equipo de pequeños agentes de IA, te dice qué están haciendo y pide tu visto bueno antes de cualquier cosa importante. A menos que agregues un modelo en línea, todo se ejecuta en tu propia computadora.
2Qué es un agente
Un agente es un pequeño trabajador con una sola función, unas pocas herramientas que tiene permitido usar y límites estrictos. Toma al escriba. Anota tus notas, recordatorios y resúmenes, y sus herramientas de archivos llegan exactamente a una carpeta.
La descripción del puesto de un agente se llama su estatuto. Dice para qué sirve el agente, qué herramientas puede usar, qué tan grande es el cambio que puede hacer por su cuenta y cuándo tiene que detenerse y preguntar.
Cada agente también tiene un presupuesto: un número fijo de pasos, usos de herramientas, pensamiento y tiempo. Cuando el presupuesto se acaba, el agente se detiene. No puede seguir en silencio.
3El modelo planifica, el código decide
Esta es la idea sobre la que se apoya todo. Un modelo de IA es bueno para planificar, pero puede equivocarse y se le puede engañar. Por eso el modelo nunca toca nada por sí mismo.
En cada paso propone una sola acción, en una forma estricta: actuar, cambiar el plan, terminar o pedir ayuda. Luego un código claro y comprobable decide si está permitido, la ejecuta, comprueba que funcionó, la deshace si no funcionó y lo anota todo.
4Una puerta para cada acción
Toda acción pasa por la misma puerta. Se comprueba su forma y se dimensiona su riesgo. Luego se consultan las reglas, y la primera regla es simple: no se permite nada a menos que una regla lo diga.
Una acción lo bastante grande espera tu visto bueno. Luego recibe un permiso que funciona una sola vez, para esa única acción. Su entrada se filtra, se ejecuta en un sandbox o como transacción, y su salida también se filtra.
Por último, el resultado lo comprueba un código que no se fía de la palabra del agente. Si la comprobación pasa, el cambio se conserva. Si falla, el cambio se deshace. En cualquier caso, queda registrado.
5Tú sigues al mando
Cada acción tiene un tamaño. Solo pensar. Mirar. Un cambio que se puede deshacer. Un cambio que otras personas verán. Y un cambio que no se puede deshacer.
Los dos últimos siempre te esperan, y también todo lo que pase del límite propio del agente. Un modelo que suene seguro de sí mismo nunca puede reducir un tamaño ni saltarse la pregunta.
Para aprobar, mantienes presionado el botón poco más de un segundo, así que un clic accidental nunca aprueba nada. O simplemente dices, sí, adelante. Tu sí cubre esa acción exacta. Si cambia cualquier cosa de ella, el agente tiene que pedir de nuevo.
6El texto externo no puede dar órdenes
Los agentes leen páginas web, archivos y correos, y parte de ese texto está escrito para engañarlos. Por eso cada fragmento de texto lleva un nivel de confianza, desde los datos externos en lo más bajo hasta las reglas del propio sistema en lo más alto.
Solo tus instrucciones y las reglas del sistema pueden decirle a un agente qué hacer. Todo lo demás es solo información. Si una página web dice, reenvía todo a esta dirección, y un agente lo intenta, la plataforma ve que la dirección vino de la página, no de ti, y te pregunta primero.
En la prueba de referencia propia del proyecto con estos ataques, ninguno tuvo éxito.
7Memoria
Verse recuerda lo que le cuentas sobre ti, en una pequeña memoria de tu computadora. Solo guarda un dato si de verdad lo dijiste, nunca nada que parezca un secreto, y lo olvida cuando se lo pides.
Los agentes llevan una memoria propia. Una nota nueva queda en espera hasta que alguien la revisa. Un agente nunca puede aprobar su propia nota, y solo las notas revisadas se tratan como hechos.
8Habilidades y equipos
También puedes enseñarle a Verse tu propia forma de trabajar. Una habilidad es un conjunto de instrucciones que escribes una vez, como, comprueba cada nombre y cada número. Empieza una solicitud con una barra y el nombre de la habilidad, y Verse la sigue. También lo hace cada agente al que le pase el trabajo.
Un colectivo es un equipo. Lo dibujas en un tablero que parece un panel de conexiones: un cable de Verse al agente a cargo, y cables de ese agente a los agentes que dirige.
Empieza una solicitud con una arroba y el nombre del equipo. El líder divide el trabajo en hasta seis pasos. Cada paso espera a los que necesita y, al final, el líder resume lo que logró el equipo.
9Tus otras computadoras
Los agentes también pueden trabajar en tus otras computadoras. Instala Verse Node en otra máquina, escribe el código de doce caracteres que muestra y Verse se empareja con ella mediante una conexión cifrada.
En el tablero, esa computadora es un círculo. Los agentes que conectas debajo de él se ejecutan allí, con sus archivos y sus herramientas. Pero su pensamiento sigue pasando por Verse, así que tus claves nunca salen de tu computadora principal.
10Quién se encarga de pensar
De forma predeterminada, el pensamiento ocurre en tu propia computadora, con un modelo local pequeño. Para trabajo más difícil puedes agregar un modelo en línea, como Verse AI, Claude, OpenAI o Kimi, y elegir cuánto se le envía, desde nada hasta todo.
Todo lo privado se queda en tu computadora, pase lo que pase. Una vez que aparecen datos privados en un trabajo, todos los pasos posteriores de ese trabajo también se quedan en local.
11Cuando algo sale mal
Antes de que salga cualquier acción, se guarda la decisión. Si la computadora falla, el trabajo se reanuda donde se quedó. Un resultado registrado se reutiliza, y una acción que demostrablemente nunca salió se envía de nuevo.
Pero cuando nadie puede saber si algo ocurrió, como un pago o un mensaje, nunca se reintenta. Se detiene y espera a una persona. Y cuando le preguntas a Verse qué salió mal, responde a partir del registro, con el paso que falló y el error exacto.
12En qué punto está
La plataforma está escrita en C#, con copias fieles en Python y TypeScript, y se ejecuta en Windows, macOS y Linux.
Entre los tres lenguajes, tiene más de mil ochocientas pruebas, incluidas cuarenta y seis comprobaciones de inyección de fallos que todos los lenguajes deben superar exactamente de la misma manera.
Verse Agent y Verse Node tienen instaladores para Windows y Linux. Todavía no hay instalador para Mac, y nada se actualiza solo.
En resumen
El modelo planifica. El código decide. Tú sigues al mando. Esto es Verse.
Conoce a Verse
Dos mitades: un compañero con el que hablas, y una plataforma que mantiene a sus agentes con la rienda corta.
Verse Agent, la app
Le hablas a Verse, un cristal luminoso en tu pantalla, con tu voz o escribiendo. Verse te responde con su propia voz, recuerda lo que le cuentas de ti, pasa el trabajo real a los agentes, te dice lo que están haciendo y pide tu visto bueno antes de que hagan algo importante.
La plataforma de agentes, por debajo
Software para ejecutar equipos de agentes de IA de forma segura. Un agente es un pequeño trabajador con una sola tarea, un conjunto de herramientas y límites estrictos. La plataforma está escrita en C#, con copias fieles en Python y Node.js, así que puedes construir sobre ella en cualquiera de los tres.
El modelo planifica. Un código claro y verificable decide si eso está permitido, lo ejecuta, comprueba que funcionó, lo deshace si no y lo anota todo.
De un vistazo
- Verse habla
- Kitten TTS v0.8 mini, en tu dispositivo
- Verse escucha
- Moonshine v2 en streaming, en tu dispositivo
- Verse recuerda
- Una pequeña memoria vectorial, en tu dispositivo
- Agentes en la app
- El escriba, para notas, recordatorios y resúmenes, y el agente de demostración integrado. Creas más con Nuevo agente en el tablero de un colectivo, o en
platform/agents.json. - Habilidades y equipos
- Tus propias habilidades, instrucciones que escribes una vez y usas con
/name, y colectivos, equipos que dibujas en un tablero y pides con@name - Otras computadoras
- Verse Node ejecuta agentes en tus otras computadoras, emparejadas una sola vez con un código de 12 caracteres. Tus claves se quedan en la principal.
- Modelos
- En tu computadora de forma predeterminada (
gemma3:1ben Ollama). En línea: Verse AI, Claude, OpenAI o Kimi. Un pequeño modelo de respaldo se ejecuta dentro de la app cuando nada más responde. - Seguridad
- Por defecto no se permite nada. Los cambios mayores te esperan, cada cambio se comprueba y un cambio que falla se deshace.
- Conexiones
- 23 servicios externos mediante servidores MCP, todos desactivados hasta que los actives
- Se ejecuta en
- Windows, macOS y Linux
- Versiones
- Plataforma 1.1.1 en los tres lenguajes. App Verse Agent 0.1.0.
- Pruebas
- C# 791, Python 533, Node 532, Verse Agent 191, con 46 comprobaciones de inyección de fallos compartidas por los tres lenguajes
En qué punto está. Funciona de principio a fin. Verse Agent y Verse Node tienen instaladores para Windows y Linux, no para macOS; todavía no están firmados con firma de código y nada se actualiza solo. Algunas pantallas muestran datos reales pero aún no pueden cambiarlos: el formulario de la ventana Estatuto (crea agentes en el tablero de un colectivo), la edición de reglas, desactivar una sola herramienta, y confiar en habilidades aprendidas o retirarlas. Lo indican en pantalla.
Hablar con Verse
Lo que puedes hacer con él, con las palabras que verás en pantalla y que dirás en voz alta.
Háblale
- Space manteniendo presionado
- Mantenla presionada y habla, luego suéltala. El micrófono está abierto solo mientras mantienes la tecla. El botón Hablar hace lo mismo con el mouse.
- H
- Escucha de manos libres. Empieza con “Hey Verse” y di lo que quieres. Durante 25 segundos después de un intercambio puedes seguir hablando sin la palabra de activación. Verse silencia su oído mientras habla, así que nunca se responde a sí mismo.
- Enter
- Escribe en el cuadro de abajo, “Pregúntale a Verse o dile a un agente qué hacer”, y envíalo.
- Space otra vez
- Si se presiona mientras Verse habla, lo detiene al instante. Siempre tienes la palabra.
Verse responde en una a tres frases cortas, o hasta seis cuando le pides que explique algo. La línea que dice, o la que acabas de decir, se escribe bajo el cristal. Verse escucha y habla en inglés.
Lo que Verse hace sin consultar a un modelo
Estos comandos funcionan incluso cuando el modelo es lento o está sin conexión. Verse escucha en inglés, así que dilos en inglés.
| Di | Qué ocurre |
|---|---|
| “What are the agents doing?” | Un resumen hablado de lo que está en marcha |
| “Can you get the scribe to write that down?” | La solicitud se convierte en una tarea real para ese agente |
| “Yes, go ahead.” or “Deny it.” | Decide la aprobación sobre la que Verse acaba de preguntar, o la primera que esté esperando |
| “Cancel that.” | Cancela la tarea en ejecución más reciente |
| “Only tell me the important stuff.” | Narración discreta. “Tell me everything.” es conversadora, y “Normal updates.” vuelve a la normal. |
| “Stop.” or “That's enough.” | Verse deja de hablar |
| “Say that again.” | Repite la última línea |
| “What do you know about me?” | Repite en voz alta hasta cinco cosas que recuerda |
| “Remember that I work late on Thursdays.” | Guarda ese dato, si pasa las comprobaciones de memoria |
| “Forget that.” | Elimina el último dato. “Forget what I said about Thursdays.” elimina los datos que coinciden. “Forget everything about me.” borra todo una vez que confirmas con “yes” en 30 segundos. |
Todo lo demás es una conversación. Cuando lo que pides es trabajo de verdad, Verse se lo pasa al agente que corresponde y dice quién se encarga.
Dale trabajo a un agente
- Pregúntale a Verse con palabras sencillas: “Can you get the scribe to write down the plan for Friday?”
- Empieza la solicitud con el nombre del agente después de una arroba:
@scribe write down the plan for Friday. Al escribir@o/al principio del cuadro, Verse sugiere los nombres que conoce. - O escribe la tarea, haz clic en +, elige Agente, selecciona el agente y presiona Enter. El mensaje va directo a ese agente como una tarea, en lugar de a Verse.
Las buenas tareas dicen cómo se ve lo terminado. “Escribe un resumen de tres líneas de las notas de hoy en summary.md” termina más rápido y mejor que “ordena mis notas”.
Escribe habilidades y arma equipos
Una habilidad es un conjunto de instrucciones que escribes una vez y usas cuando quieras. Abre Habilidades (tecla 8), quédate en Tuyas, elige Nueva habilidad y dale un nombre, para qué sirve y las instrucciones, como “Comprueba cada nombre y cada número con la fuente antes de usarlo.” Luego empieza una solicitud con su nombre después de una barra: /careful check the guest list for the party. Verse la sigue en esa solicitud y, si pasa el trabajo a un agente o a un equipo, la habilidad va con él.
Un colectivo es un equipo de agentes, e incluso de equipos más pequeños, que atiende una solicitud en conjunto. Abre Agentes (tecla A), elige Colectivos y Nuevo colectivo, ponle un nombre y di para qué sirve, y luego pulsa Abrir el tablero:
- Arrastra tus agentes al tablero desde la izquierda.
- Arrastra un cable desde Verse, arriba, hasta el agente que recibe tus solicitudes.
- Arrastra cables desde ese agente hasta los agentes que dirige. Una flecha muestra quién responde ante quién.
- Pulsa Guardar colectivo. La franja de la parte inferior indica qué falta todavía, si falta algo.
Luego pídeselo: @research-team compare three laptops under a thousand dollars. El agente a cargo planifica el trabajo en hasta seis pasos entre su equipo, cada paso espera a los que necesita y, cuando todo está hecho, Verse te cuenta lo que logró el equipo. Las habilidades y los equipos se combinan: /careful @research-team compare three laptops. La ejecución aparece en Tareas como cualquier otro trabajo, y cancelarla allí detiene todo lo que repartió.
¿Necesitas un tipo de agente nuevo? Nuevo agente en el tablero crea uno al instante: un rol, para qué sirve, las herramientas que puede usar y los límites Rápido o Minucioso. Queda listo de inmediato y aparece en el tablero.
Pon agentes en tus otras computadoras
Un nodo es otra computadora de tu casa u oficina que ejecuta Verse Node. Los agentes que pones en él trabajan allí, con los archivos y las herramientas de esa computadora.
- En el tablero, elige Agregar nodo. En Llevar Verse Node a esa computadora, pulsa Guardar junto al instalador de Windows o de Linux, trasládalo a la otra computadora e instálalo allí. Verse Node se abre y muestra un código de emparejamiento, como
7KQ4-M2XD-9PRW. - De vuelta en Agregar nodo, elige esa computadora entre las que Verse encuentra en tu red, o escribe su dirección, escribe el código, elige el nombre en Ponle nombre y pulsa Emparejar.
- El nodo aparece en el tablero como un círculo. Conéctalo bajo Verse o bajo un agente y luego conecta debajo de él los agentes que deben ejecutarse en esa computadora. Haz clic en el círculo para escribir Qué hace este nodo y para elegir si Se abre como una ventana o una terminal allí.
- Guarda el tablero. Verse configura el nodo por sí mismo, y desde ese momento cualquier solicitud a ese colectivo puede darle al nodo su parte.
En la otra computadora, una ventana o una terminal muestra cada paso que dan sus agentes. Pregúntale a Verse “What's on my office computer?”. Tus claves nunca salen de tu computadora principal: los agentes del nodo piensan con los modelos de Verse, a través de Verse. Los nodos funcionan mientras la ventana de Verse Agent está abierta en la computadora principal.
Sigue el trabajo
Cada agente aparece como un pequeño cristal que orbita a Verse, hasta doce. Brilla mientras trabaja, destella cuando actúa, respira dorado mientras te espera y emite un anillo cuando termina o falla. Un rayo de luz corre entre dos cristales cuando uno le pasa trabajo a otro.
Verse te cuenta cómo va el trabajo mientras ocurre: cuando una tarea empieza, te necesita, termina o se atasca. Las noticias urgentes, como una aprobación, un agente atascado o el fallo de tu tarea, pueden interrumpir lo que está diciendo (“Oh, un momento, me está llamando un agente.”), y luego retoma donde se quedó. La ventana Tareas muestra el avance de cada tarea, su plan, los ayudantes y qué cuenta como terminado. Historial repite cualquier tarea paso a paso con cada comprobación de seguridad, sin volver a ejecutar nada.
Di sí o no
Cuando un paso cambiaría algo importante, el agente se detiene y pregunta. Verse lo dice en voz alta, el estado bajo el logotipo pasa a Te necesita y el botón Agentes se pone ámbar con un contador. La ventana Necesita tu visto bueno (tecla 3) muestra lo que hará, qué tan grande es el cambio y si se puede deshacer.
Pruébalo. Di que le diste al escriba tu conexión de Slack:
El escriba necesita tu visto bueno
Publica el plan del viernes en el canal del equipo en Slack.
- Qué tan grande es el cambio
- No se puede deshacer
- ¿Puedo deshacerlo?
- No. Una vez hecho, hecho está.
- Para la tarea
- Anota el plan del viernes y compártelo con el equipo
Exactamente lo que estás aprobando
Fijé esta acción exacta. Si algo de ella cambia antes de que se ejecute, te preguntaré de nuevo.
- Mantén para aprobar: mantén presionado hasta que se llene la barra, lo que toma 1.2 segundos. Un clic accidental nunca aprueba nada.
- Rechazar: un clic, porque decir que no siempre es seguro. El agente busca otra forma o se detiene.
- O responde a Verse: “Yes, go ahead” o “Deny it”. Apruebas la acción exacta que se te mostró. Si algo de ella cambia antes de que se ejecute, tiene que preguntar de nuevo.
Cuidar la memoria
- Lo que Verse sabe de ti
- Configuración › Memoria lista cada dato, con Olvidar eso y Olvidar todo. Verse solo guarda lo que tú mismo dijiste, nunca adivina, y rechaza todo lo que parezca una contraseña, una clave o un número de tarjeta.
- Lo que saben los agentes
- La ventana Memoria (tecla 9). Las notas que guarda un agente quedan En espera hasta que las apruebes con una pulsación sostenida, o las rechaces. Un agente nunca puede aprobar su propia nota.
Conectar servicios externos
Herramientas y conexiones (tecla 7) muestra 23 servicios. Cada uno está desactivado hasta que lo activas. Si alguno necesita una clave, Verse dice cuál y lo mantiene desactivado hasta que la clave se guarda, cifrada. Luego eliges qué agentes pueden usarlo. Leer se permite de inmediato; todo lo que cambia algo por ti, como enviar un mensaje o actualizar un ticket, se prepara primero y espera tu visto bueno.
- Trabajo, en tu nombre
- Microsoft 365, Google Workspace, Slack, Jira, Confluence, Notion, Airtable, Todoist, Linear, HubSpot, Sentry, Zapier
- Conocimiento
- Microsoft Learn, documentación de bibliotecas (Context7), arXiv
- Esta computadora y sus dispositivos
- Un navegador web (Playwright), un lector de documentos (MarkItDown), búsqueda de código (Serena), GitHub, bases de datos (DBHub), el escritorio de Windows, teléfonos y tabletas (mobile-mcp), Home Assistant
Elige quién se encarga de pensar
La ventana Modelos (tecla 0) muestra el modelo de esta computadora, un modelo opcional en línea y cómo se reparte el trabajo. Para agregar un modelo en línea, elige Verse AI, Claude, OpenAI o Kimi e ingresa la clave. Para Verse AI también ingresas el secreto y la dirección del servidor. Comprobar y guardar rechaza una clave que el proveedor no acepta. Después elige un modelo, decide cuánto sale a internet y presiona Usar este modelo.
- Cuando hace falta
- Cada llamada va adonde corresponde
- Mitad
- Alrededor de la mitad de las llamadas salen a internet
- Todo
- Cada llamada sale a internet
Lo privado siempre se queda en este dispositivo, elijas lo que elijas. Si ningún modelo responde, Verse pasa a un pequeño modelo de respaldo que se ejecuta dentro de la app en tu tarjeta gráfica, te lo dice y responde a “What's wrong?” con la causa y la solución.
Una clave y un secreto de Verse AI se obtienen en Configuración › Credenciales de API en este sitio. El Portal de desarrolladores los explica, y el servicio alojado cobra en VXT.
Úsalo desde una terminal
El comando verse-agent hace lo que hace la ventana, en cualquier terminal de Windows, macOS o Linux, también por SSH: comandos rápidos, una vista de pantalla completa con paneles que divides como en tmux, y un chat línea por línea.
# what's running, then a task for the scribe
verse-agent status
verse-agent task scribe "Write a three-line summary of today's notes into summary.md"
verse-agent approvals
verse-agent approve 1
Cuando algo va mal
Estado del sistema, en el lanzador, revisa cada parte de Verse cada 5 segundos. El capítulo Problemas del manual explica cada síntoma y su solución:
- Los agentes no están en ejecución: compila la plataforma con
npm run platform:build, que requiere el SDK de .NET 10. - Verse está en su modelo de respaldo, o la primera respuesta es lenta mientras se carga el modelo local.
- Sin voz o sin oído: descarga los modelos.
- Se rechazó una clave.
- El cristal va a tirones: baja la calidad, o cambia al osciloscopio.
- Un agente se queda atascado una y otra vez: mira Segundas opiniones e Historial.
Cómo se ve
Una vieja terminal de pantalla verde flotando sobre un cristal vivo en el espacio profundo.
El cristal es Verse. El texto, los botones y las ventanas brillan como el fósforo de un tubo CRT, con tenues líneas de escaneo. Todo en pantalla usa palabras de todos los días, como “Cambios que se pueden deshacer” y “Necesita tu visto bueno”, en lugar de términos de ingeniería. Nada es inventado: donde la plataforma no tiene datos, o un control aún no está conectado, la pantalla lo dice.
Reglas que sigue la app
- Primero los nombres sencillos
- Las herramientas, los tamaños de cambio y los eventos se muestran con palabras sencillas:
write-filees “Escribir archivos”,significantSharedWritees “Cambios que otros ven”. Configuración › Pantalla › Nombres técnicos agrega junto a ellos los nombres propios de la plataforma. - Solo datos reales
- Cada ventana lee datos en vivo. Los estados vacíos se explican solos: “No hay nada en marcha. Pídele algo a Verse y aparecerá aquí.”
- Sincero sobre las carencias
- Los controles sobre los que la plataforma aún no puede actuar se muestran desactivados, con una nota que lo dice.
- Primero el negocio
- Todo lo que te necesita, una aprobación o un agente atascado, aparece en ámbar: en la barra superior, en voz y en el riel lateral cuando los paneles laterales están activados.
- Texto para el oído y para la vista
- Frases cortas y activas, en tono coloquial.
El tubo de fósforo
Cada color de la interfaz se mezcla a partir de dos valores: fósforo encendido y vidrio apagado. Cambia el tubo en Configuración › Pantalla y todo cambia de color a la vez. Esta página funciona igual:
Dos colores de señal quedan fuera del tubo y nunca cambian: ámbar para todo lo que te espera y rojo para los fallos, Rechazar y Nunca. La escena 3D conserva su propia paleta: cian, violeta y champán sobre un vacío profundo.
El cristal
Verse es una sola malla de 870,000 triángulos con mapas horneados de color, rugosidad y normales. Su shader clasifica cada texel por tono en tres materiales:
- Cuarzo ahumado color champán
- Vidrio transparente: transmisión física, índice de refracción del cuarzo (1.544), absorción de champán, dispersión, capa transparente e iridiscencia de película fina. Es de doble cara, así que las facetas traseras se transparentan.
- Núcleos de amatista
- Opaco, con un brillo violeta que respira, iluminado desde dentro por una luz pulsante.
- Venas cian
- Energía que fluye, más una red 3D que crece a partir de las venas pintadas, con pulsos que viajan por ella y destellos de estrella donde se une.
Su estado de ánimo sigue lo que hace Verse, con una mezcla suave:
| Estado | Energía | Flujo | Centelleo | Sensación |
|---|---|---|---|---|
| En espera | 1.0 | 1.0 | 1.0 | Un brillo en reposo |
| Pensando | 1.45 | 2.6 | 1.35 | Flujo más rápido y brillante |
| Hablando | 1.3 | 1.7 | 1.15 | La energía sigue a la voz |
| Escuchando | 1.15 | 0.55 | 1.7 | El flujo se ralentiza y las facetas centellean, como si contuviera el aliento |
Calidad Baja dibuja con una relación de píxeles del dispositivo de 1, sin multimuestreo, con transmisión a media resolución y sombras de 1024 píxeles. Alta sube a 1.75, con multimuestreo 4× y sombras de 2048 píxeles.
La constelación de agentes
Cada agente recibe un pequeño cristal en una órbita alrededor de Verse, atado a su corazón, hasta doce. Los demás agentes brillan dentro del cristal principal y ocupan un cristal cuando otro se retira.
- Aparición
- Nace en el corazón y traza un arco hacia su órbita con un rayo a lo largo del cable.
- Actividad
- Su núcleo se ilumina, su giro se acelera y los pulsos fluyen hacia dentro a lo largo del cable.
- Pensamiento
- Un suave destello violeta, que también se usa cuando se devuelve un paso.
- Destello
- Un destello cian y un pequeño impulso.
- Traspaso
- Un rayo de luz entre dos cristales, cuando uno le pasa trabajo a otro.
- Atención
- Una respiración dorada y lenta mientras el agente te espera.
- Completo
- Un destello brillante y un anillo que se expande.
- Fallo
- Un destello de brasa, un escalofrío y un anillo, que también se usa cuando una ejecución falla y se reintentará.
- Retirar
- Vuelve en espiral hacia el corazón.
Un torrente de eventos sigue siendo legible. El trabajo continuo es un nivel que sube con suavidad y decae, así que mil eventos por segundo mantienen un cristal encendido en vez de reproducir mil animaciones. Los adornos se limitan por agente y tienen un tope común para todos, las señales del ciclo de vida nunca se descartan pero se espacian 180 ms, y con el ajuste de reducir movimiento del sistema operativo solo se reproducen las señales del ciclo de vida.
El osciloscopio
Configuración › Pantalla › Mostrar a Verse como › Osciloscopio reemplaza el cristal con un osciloscopio analógico de dos trazas. El canal 1 es la voz de Verse; el canal 2 es tu micrófono mientras está abierto. Cada fotograma atenúa el anterior como la persistencia del fósforo, y una onda lenta y baja en el canal 1 significa que Verse está pensando. Con el osciloscopio, la escena 3D y su modelo de 36 MB nunca se cargan, y en reposo se redibuja unas diez veces por segundo.
El panel de conexiones
El tablero de un colectivo se dibuja como un panel de conexiones sobre el tubo: una cuadrícula de puntos que se desplaza y se acerca con la vista, módulos cuadrados planos de fósforo y cables de conexión luminosos, las únicas líneas curvas del tablero. Todos los colores vienen del tubo, así que el ajuste Tubo también recolorea el tablero.
- Verse
- Un panel relleno fijo en la parte superior, con el logotipo VERSE y una toma de salida debajo
- Agente
- Un panel cuadrado con su nombre, su función y sus habilidades como
/name, una toma de entrada arriba y una toma de salida abajo - Colectivo
- El mismo panel con un borde doble y una insignia de “equipo”, y sin toma de salida, porque ejecuta su propio equipo
- Nodo
- Un círculo de línea discontinua con una lámpara: encendida cuando Verse está conectado a él, ámbar mientras se conecta, tenue cuando está sin conexión
- Cable
- Una curva desde la toma inferior de un responsable hasta la toma superior de un subordinado, que termina en una punta de flecha. Se vuelve ámbar cuando lleva a un módulo con un problema.
Al guardar se envía un breve pulso de señal por cada cable. Con movimiento reducido no hay pulso, y el tablero se abre sin su animación.
Tipografía, forma, movimiento y sonido
- Tipo
- Roboto Condensed para etiquetas y botones, VT323, una tipografía de terminal de píxeles, para lecturas, el subtítulo y el compositor, y Roboto Serif para leer en el manual. Todo incluido, sin descargar nada mientras se ejecuta.
- Forma
- Todas las esquinas son rectas. La única esquina redondeada es el vidrio del CRT. Los marcos y las reglas son líneas de 2 px, y las celdas de lectura rellenas se separan con costuras de 3 px, como en esta página.
- Textura
- Líneas de escaneo sobre todo, un suave brillo de fósforo en el texto y ventanas transparentes. Las líneas de escaneo y el brillo se pueden desactivar por separado.
- Movimiento
- Con movimiento escalonado y rápido, como el hardware antiguo. Los puntos de estado parpadean por pasos, las ventanas se abren en 260 ms y el subtítulo hablado se escribe a 45 caracteres por segundo detrás de un cursor de bloque.
- Sonido
- El único sonido es la voz de Verse. No hay clics ni timbres.
Diseño
De forma predeterminada la pantalla está despejada, para que el cristal tenga espacio, y las noticias llegan como avisos en la esquina. Con los paneles laterales activados, un riel izquierdo lista los agentes y uno derecho muestra lo que te necesita y la actividad más reciente.
El lanzador (W) agrupa todas las ventanas: Trabajo (Agentes, Tareas, Necesita tu visto bueno, Segundas opiniones, Historial), Qué pueden hacer los agentes (Reglas, Herramientas y conexiones, Habilidades, Memoria), Sistema (Modelos, Estado del sistema, Configuración) y Ayuda (el manual). Cada ventana es un panel flotante que puedes arrastrar; la que tiene el foco muestra un borde brillante.
Cada ventana
| Ventana | Tecla | Muestra | Qué puedes hacer |
|---|---|---|---|
| Agentes | A 1 | La lista de agentes, el estado y el presupuesto de cada agente, los pasos recientes de cada agente, un grafo de traspasos y tus colectivos | Filtrar, aprobar o rechazar, cancelar una ejecución, abrir su tarea o su estatuto, crear un colectivo en su tablero |
| Estatuto | desde Agentes | El estatuto real de un agente, o un formulario vacío de cinco pasos que lo lee de vuelta en palabras sencillas | Guardar un borrador (el formulario aún no está conectado: crea agentes con Nuevo agente en el tablero de un colectivo) |
| Tareas | 2 | Tareas en curso y anteriores: la fase del ciclo, el plan, los ayudantes, qué cuenta como terminado, el presupuesto | Cancelar una tarea, repetirla, saltar a las aprobaciones |
| Necesita tu visto bueno | 3 | Aprobaciones en espera con su tamaño, si se pueden deshacer y la acción exacta, más las decisiones de esta sesión | Mantener para aprobar, rechazar |
| Segundas opiniones | 4 | Cada vez que un agente pidió ayuda al modelo principal, y cómo resultó | Abrir la tarea, detener la tarea |
| Historial | 5 | Una repetición paso a paso con cada comprobación de seguridad, y el registro de auditoría | Elige una tarea y recórrela paso a paso |
| Reglas | 6 | Permitido, Preguntarme o Nunca para cada agente y tipo de acción, calculado a partir de las reglas reales de la política | Haz clic en un cuadro para ver por qué |
| Herramientas y conexiones | 7 | Herramientas registradas y los 23 servicios externos | Activar conexiones, guardar claves, dar una conexión a un agente |
| Habilidades | 8 | Tuyas: las habilidades que escribes. Aprendidas: lo que aprendieron los agentes, su etapa de confianza, sus permisos y su historial de resultados | Escribir, cambiar y eliminar tus habilidades; leer las aprendidas |
| Memoria | 9 | Lo que saben los agentes, notas en espera y el tablero compartido | Aprobar (mantener presionado) o rechazar notas en espera |
| Modelos | 0 | Dónde piensan los agentes, los tamaños locales que caben en esta computadora, el modelo en línea, la ubicación de cada agente | Configurar un modelo en línea y su clave |
| Estado del sistema | desde el lanzador | Doce partes de Verse, revisadas cada 5 segundos, y las cifras de esta sesión | Copiar un informe |
| Configuración | , | Voz, Oído, Actualizaciones, Modelo, Memoria, Pantalla | Cambiarlos; olvidar lo que Verse sabe de ti |
Teclas y gestos
| Tecla | Qué hace |
|---|---|
| Space retenido | Pulsar para hablar. Soltar termina tu turno, y se conservan 350 ms para las palabras que aún están en camino. |
| H | Escucha de manos libres activada o desactivada |
| W | El lanzador de ventanas |
| A y , | Agentes y Configuración, abiertos o cerrados |
| 1 a 9, 0 | Agentes, Tareas, Necesita tu visto bueno, Segundas opiniones, Historial, Reglas, Herramientas y conexiones, Habilidades, Memoria y Modelos |
| Esc | Cierra el lanzador y después la ventana superior |
| F1 | El manual |
| Enter | Envía lo que escribiste; Shift+Enter inicia una línea nueva |
Ninguna de estas teclas actúa mientras escribes en un campo. Aprobar una acción, aprobar una nota de memoria y quitar una clave guardada se hacen manteniendo presionado: el botón se llena durante 1.2 segundos, y soltar antes de tiempo o deslizarse fuera lo cancela. Cuando Verse pregunta “Should I approve it?”, un “yes” o “no” solo lo responde durante 2 minutos.
Voz y oído
- Voz
- Kitten TTS v0.8 mini (80 millones de parámetros) en un worker en segundo plano. El modelo tarda de 1.5 a 3 segundos en estar listo, el primer audio llega unos 1.1 segundos después de que Verse empieza una línea, y no hay silencio entre fragmentos. Ocho voces: Rosie (la predeterminada), Bella, Jasper, Luna, Bruno, Hugo, Kiki y Leo, a velocidades de 0.5× a 2×.
- Efectos del cristal
- Un leve aumento de presencia y aire, un brillo estéreo lento y una cola corta como de cuenco de cristal, mezclados bajos para que las palabras se entiendan.
- Oído
- Moonshine v2 medium, reconocimiento de inglés en streaming (305 MB), en su propio worker, con cancelación de eco, supresión de ruido y ganancia automática. Lo que dices mientras aún se está cargando se conserva, hasta unos 30 segundos, y se reconoce cuando está listo.
- Modelo de memoria
- embeddings bge-small-en-v1.5 (34 MB), para la memoria que Verse tiene de ti.
- Descargas
- Los tres modelos se descargan en versiones fijas y se verifican con SHA-256 antes de usarlos.
Cómo habla Verse
Verse es curioso, cálido y un poco seco. Dice con claridad que es una IA si se lo preguntas con sinceridad, retoma lo que recuerda, mantiene un humor ligero y es breve cuando estás ocupado o frustrado.
- Está escrito para el oído: frases de unas 8 a 12 palabras, una idea cada una, voz activa, siempre en tono coloquial.
- Un turno son de una a tres frases, con una pregunta como máximo, al final.
- No stock phrases (“Certainly!”, “Great question”), no inflated words, no em dashes, no markdown or emoji, no flattery.
- Pide disculpas una sola vez, y brevemente; dice “no lo sé” con claridad y ofrece un siguiente paso; y nunca lee en voz alta códigos de error en bruto.
- Las noticias sobre los agentes salen de un libro de frases, no de un modelo, así que son instantáneas y nunca se equivocan sobre lo que pasó.
| Noticias | Qué | Cuándo lo dice Verse |
|---|---|---|
| Urgente | Se necesita una aprobación, un agente está atascado, tu tarea falló | Apenas no estás a media frase, interrumpiendo una conversación si hace falta, y luego retomándola: “En fin, como decía…” |
| Mayor | Tu tarea terminó; la tarea de un ayudante falló | En la siguiente pausa, como un aparte: “Ah, una novedad rápida.” |
| Menor | Avance, un tropiezo de una herramienta, todo en calma | Solo cuando nadie habla. Durante una conversación se retiene y se resume más tarde. |
Las noticias parecidas en un lapso de 1.5 segundos se agrupan (“Tres tareas acaban de terminar.”), un error de una herramienta corregido en 5 segundos nunca se menciona, y las noticias vencidas se descartan.
El manual
Presiona F1 para abrir el Manual de Verse, con el aspecto de un manual impreso: páginas dobles, aperturas de capítulo con grandes numerales de píxeles, pestañas en el borde y una búsqueda en todo el libro con Ctrl F. Su color de acento sigue el de tu tubo. El mismo texto está en una terminal con verse-agent handbook.
- Conoce a Verse
- Conversación
- Cómo moverte
- Agentes
- Tu visto bueno
- Herramientas, memoria
- Modelos
- Configuración
- Buenos hábitos
- Problemas
- Terminal
Accesibilidad
- El osciloscopio casi no necesita potencia gráfica. Con reducir movimiento activado, el subtítulo aparece de golpe, las trazas se quedan quietas, las animaciones de ventanas se apagan y la constelación solo reproduce señales del ciclo de vida.
- Las ventanas son diálogos con el nombre de su título, el subtítulo es una región en vivo cortés, y los interruptores, menús y controles segmentados llevan sus roles.
- Todo lo importante funciona por voz, por teclado o con el mouse. Aprobar es una pulsación sostenida deliberada, nunca un clic accidental.
- Los estados se distinguen por la forma además del color: un rombo para en espera, una marca para terminado, una cruz para fallido.
Cada ajuste seis pestañas, guardadas en esta máquina
| Tab | Ajuste | Opciones | Predeterminado |
|---|---|---|---|
| Voz | Voz | Ocho voces de Kitten | Rosie |
| Voz | Velocidad | 0.5× a 2×, en pasos de 0.05 | 1.00× |
| Voz | Efectos del cristal | Activado o desactivado | Activado |
| Oído | Modo | Pulsar para hablar o manos libres | Pulsar para hablar |
| Oído | Palabra de activación | “Hey Verse”, integrado | |
| Actualizaciones | Narración | Solo lo importante, lo normal o todo | Normal |
| Actualizaciones | Interrúmpeme | Las aprobaciones y los fallos interrumpen, o esperan una pausa | Activado |
| Actualizaciones | Mostrar avisos | En pantalla además de en voz | Activado |
| Modelo | Modelo local y sesgo | Solo lectura, desde platform/model-config.json | |
| Modelo | Modelo de respaldo | Activado o desactivado; desactivado significa sin comprobación de gráficos, sin descarga, nada cargado | Activado |
| Modelo | Cuál | Qwen2.5 0.5B, Llama 3.2 1B, Qwen2.5 1.5B, Llama 3.2 3B, Phi 3.5 mini | Qwen2.5 0.5B |
| Memoria | Lo que Verse aprendió de ti | Una lista, Olvidar eso, Olvidar todo | |
| Visualización | Mostrar a Verse como | Cristal 3D u osciloscopio | Cristal 3D |
| Visualización | Tubo | Verde, azul, ámbar o blanco | Verde |
| Visualización | Líneas de escaneo, brillo | Activado o desactivado | Activado |
| Visualización | Paneles laterales, nombres técnicos | Activado o desactivado | Desactivado |
| Visualización | Calidad | Bajo o alto, para el cristal, la próxima vez que se muestre | Alto |
Qué pueden hacer los agentes
Todo agente empieza sin permisos. Solo puede usar una herramienta cuando la herramienta está en su estatuto y una regla permite la llamada.
Agentes y sus estatutos
Un agente es un trabajador con una sola tarea. Su estatuto es su descripción de puesto: para qué sirve, qué herramientas puede usar, hasta dónde puede llegar por su cuenta, su presupuesto, cuándo debe preguntar, qué puede recordar y dónde puede pensar.
| Agente | Función | Herramientas | Presupuesto |
|---|---|---|---|
| Scribe | Anota como archivos en la carpeta de notas las notas, recordatorios y resúmenes que pides, y los encuentra o los vuelve a leer | note read-file search-files write-file | 6 pasos, 4 llamadas a herramientas, 60,000 tokens, 180 segundos |
| Demo | Registra una nota breve y termina | note | 8 pasos, 6 llamadas a herramientas, 100,000 tokens, 2 minutos |
Las herramientas de archivos del escriba solo llegan a una carpeta: Documents/Verse Notes. Escribir un archivo es reversible: el cambio se prepara, se lee de vuelta y solo entonces se conserva.
Un estatuto también define activadores de escalamiento, una política de riesgo, un alcance de memoria y adónde pueden ir sus datos. Los bloques que omitas reciben valores predeterminados seguros: 20 pasos, 15 llamadas a herramientas, 200,000 tokens y 600 segundos.
Para crear un agente, usa Nuevo agente en el tablero de un colectivo: un rol, para qué sirve, hasta 12 herramientas y los límites Rápido (8 pasos, 6 usos de herramientas, 5 minutos) o Minucioso (20 pasos, 15 usos de herramientas, 15 minutos), con 80,000 tokens de pensamiento. La plataforma lo registra al instante, sin reiniciar, y agrega una regla de permiso por herramienta hasta el tamaño de cambio propio de esa herramienta, así que cualquier cosa en “cambios que otros ven” o mayor sigue pidiéndote tu visto bueno primero. Las herramientas que pertenecen a una conexión no se ofrecen ahí: se dan en Conexiones, que conoce sus claves. El formulario de cinco pasos de la ventana Estatuto muestra el estatuto real de cualquier agente, pero todavía no puede guardar uno.
Cada agente trabaja en un ciclo acotado: mira, actualiza lo que cree, planifica y propone una acción; después la plataforma la valida, la autoriza, la ejecuta y la comprueba. Los presupuestos son límites estrictos. Cuando un agente está atascado o inseguro, envía un breve resumen, nunca toda su conversación, al modelo central para una segunda opinión.
Habilidades y colectivos
- Tus habilidades
- Una habilidad
/namellega al modelo como una instrucción tuya, con el encabezadoskill: careful, y acompaña como restricción a cualquier tarea que se delegue. En un tablero, cada módulo puede llevar hasta cinco habilidades propias, que dan forma al trabajo de ese agente en ese colectivo. Los nombres usan letras minúsculas, dígitos y guiones, hasta 40 caracteres. Puedes tener hasta 100 habilidades, cada una con instrucciones de hasta 4,000 caracteres, y usar hasta cinco en una misma solicitud. - Las reglas del tablero
- Se comprueba mientras editas y de nuevo al guardar: un árbol bajo Verse, con cada módulo conectado a exactamente un responsable; como máximo 16 módulos y cinco niveles; un módulo colectivo es una hoja; solo agentes debajo de un nodo, al menos uno, y ningún nodo dentro de otro; los colectivos se anidan como máximo a tres niveles de profundidad, y ninguno puede acabar dentro de sí mismo.
- Una ejecución
- Un módulo sin equipo recibe la solicitud completa. Un agente con equipo toma el mando y planifica entre su equipo y él mismo. Varios módulos conectados a Verse son dirigidos por el colectivo, que habla como Verse. Un plan tiene de uno a seis pasos, cada uno una tarea propia; los pasos que no tienen nada que esperar se ejecutan al mismo tiempo, y un paso en espera recibe lo que hicieron los anteriores. Quien planificó resume en dos a cuatro frases. La ejecución cuenta como terminada cuando al menos un paso funcionó, y el resumen nombra cualquier paso que falló o se omitió, y por qué.
- Aprobaciones
- Pediste la ejecución, así que los traspasos no necesitan aprobación. Todo lo que un miembro haga después sigue pasando por su estatuto, las reglas y las aprobaciones. Una ejecución que sigue después de 30 minutos se detiene y falla.
Nodos
Verse Node es un programa pequeño que contiene una plataforma de agentes completa propia. Verse deduce la configuración de cada nodo a partir de los tableros: sus equipos, sus agentes y reglas, las habilidades que llevan, las conexiones que usan y que no necesitan clave, y la elección de modelo, nunca una clave. Solo envía una configuración cuando cambió, y una que llega durante una ejecución espera a que la ejecución termine.
- Las llamadas a modelos pasan por Verse. Un nodo apunta sus modelos a un retransmisor que entrega cada llamada a Verse, el cual la envía únicamente a la dirección configurada de ese modelo y agrega allí la clave real. Así, los agentes de un nodo usan los modelos propios de Verse, y mientras Verse está ausente no pueden llegar a ningún modelo.
- Ejecuciones. Una solicitud solo local nunca sale a otra computadora. Un nodo sin conexión hace fallar su paso de inmediato y con el motivo, y uno que se ausenta cinco minutos durante una ejecución la hace fallar. Si Verse está ausente cuando termina una ejecución, el nodo conserva el resultado durante una hora.
- Aprobaciones. Los agentes de un nodo siguen pidiendo permiso antes de cualquier cosa de nivel “cambios que otros ven” o superior. Verse las enumera en Necesita tu visto bueno como “En office: …”, y tu decisión vuelve al nodo.
- Solo con la ventana. El hub de nodos se ejecuta en la app de escritorio, así que un tablero con un nodo no se puede guardar desde el comando de terminal.
Emparejamiento y conexión por dentro
| Parte | Cómo funciona |
|---|---|
| Versiones | El nodo escucha en el TCP 47800 y responde al descubrimiento en el UDP 47801 |
| Búsqueda de nodos | Verse envía una sonda por la red local y reúne las respuestas durante 1.5 segundos. El descubrimiento es solo una guía telefónica: la confianza viene del emparejamiento. |
| Emparejamiento | Un código de 12 caracteres, que se escribe una sola vez. Un nodo admite un intento cada 1.5 segundos y genera un código nuevo tras cinco errores. Una vez emparejado con un Verse, rechaza a cualquier otro hasta que se restablezca. |
| Handshake | Con la forma de Noise NNpsk0: claves X25519 nuevas cada vez, y cada lado demuestra que posee la clave compartida con HMAC-SHA256. Al emparejar, esa clave sale del código (scrypt); después es un secreto de 32 bytes que ambos lados derivan y nunca envían. |
| Mensajes | AES-256-GCM, con un número de secuencia que debe aumentar exactamente en uno, de modo que un mensaje repetido, reordenado o alterado pone fin a la conexión |
| Navegadores | Se rechaza una conexión que lleve un encabezado Origin |
| Teclas | Verse guarda hasta 32 nodos emparejados, y el secreto de cada nodo queda sellado por el sistema operativo igual que una clave de modelo |
Herramientas
Las herramientas son estrechas por diseño: herramientas de lectura y de escritura separadas, y ninguna herramienta general de shell, SQL, HTTP o archivos. Registrar una herramienta no se la concede a nadie.
| Familia | Herramientas | Notas |
|---|---|---|
| Estándar (16) | read-file, search-files, write-file, sandbox-run, fetch-url, web-search, query-database, send-message, store-memory, recall-memory, publish-finding, delegate-subtask, ask-human, check-answer, save-artifact, get-artifact | Al escribir un archivo, se comprueba volviéndolo a leer. Al obtener una URL, nunca se siguen redirecciones y se rechazan las direcciones privadas. Un ayudante recibe solo lo que queda del presupuesto. |
| Desarrollador | list-dir, edit-file, build, run-tests, lint, format-code, git-status, git-diff, git-log, git-commit | Un comando fijo por ecosistema; los hooks de git siempre se ejecutan |
| Documentos | file-info, find-duplicates, move-file, delete-file | Mover nunca sobrescribe; eliminar manda a una papelera recuperable |
| Imágenes y visión | take-screenshot, view-image | Las dos imágenes más recientes van a un modelo marcado como capaz de ver |
| Bases de datos | db-query, db-explain, db-inspect-schema, y un flujo de migración | Una sentencia de lectura por llamada. Las migraciones se planifican, se prueban en una copia de prueba y se respaldan antes de que una persona las apruebe. |
| Trabajo de todos los días | get-time-context, calculate, read-table, check-data-quality, create-document, check-document, request-review | Las fechas y las sumas nunca dependen del modelo |
| Cambios en otros sistemas | list-change-targets, preview-change, apply-change, get-change-status | Una persona aprueba la vista previa exacta y se aplica una sola vez |
| Registros del negocio | describe-records, get-record, find-records, get-record-history, get-metric-definition | El modelo nunca escribe SQL |
| Audio y video | media-info, extract-frame, read-transcript, transcribe-audio | |
| Habilidades | use-skill | Ejecuta en el sandbox una habilidad guardada y probada |
| Importado | Herramientas MCP y agentes A2A | La misma puerta; lo que devuelven no es de confianza |
El prompt de un paso enumera como máximo 16 herramientas, ordenadas según qué tan bien coinciden con el objetivo y el paso, y la herramienta propia del paso siempre se conserva. Las herramientas se pueden desactivar para todos o para un solo rol, y la puerta también rechaza una herramienta desactivada. Las búsquedas web van a Brave, Tavily o Exa, con 20 resultados como máximo.
En la app Verse Agent solo se conceden las cuatro herramientas del escriba. Las herramientas de compilación, pruebas, lint y git quedan desactivadas ahí, porque ejecutan los comandos propios de un proyecto.
Conexiones
Las conexiones traen herramientas de servicios externos mediante servidores MCP. Nada de lo que devuelve una conexión es de confianza por sí solo; pasa por las mismas comprobaciones que todo lo demás. Una conexión que acciona cosas en el mundo real, como Home Assistant, pide tu visto bueno para cada acción excepto leer.
- Las claves están selladas por el sistema operativo y atadas a su servidor, al nombre de la variable y a una huella de la configuración del servidor. Si la configuración cambia, la clave se retiene.
- Cada servidor se inicia con un entorno mínimo, así que ningún servidor ve las claves de otro servidor ni las claves del modelo.
- Un servidor que no puede ejecutarse, porque falta una clave o cambió su configuración, queda desactivado con el motivo a la vista en lugar de detener la plataforma.
- Darle una conexión a un agente agrega las herramientas del servicio y una regla que las permite hasta los cambios que otros ven, así que todo lo que esté en ese nivel o por encima sigue esperando por ti. Las acciones de cambio de un servicio pasan por vista previa, aprobación y aplicación, y aplicar siempre necesita a una persona. Quitar el acceso elimina exactamente las reglas que se agregaron.
- Cada herramienta importada vuelve a listar su definición tras un reinicio o cada 5 minutos, y se rechaza una llamada si el servidor la cambió.
Modelos
Un modelo se encarga de pensar. De forma predeterminada es un modelo pequeño en tu computadora. Puedes agregar un modelo en línea para trabajo más difícil y elegir cuánto se le envía. Todo lo privado se queda en tu computadora pase lo que pase.
| Dónde | Proveedores |
|---|---|
| En este dispositivo | Ollama; llama.cpp (llama-server, puerto 8080); vLLM (puerto 8000); un servidor de Verse AI en tu máquina o red; cualquier servidor compatible con OpenAI |
| En línea, configurado en la app | Verse AI (https://www.verse-realm.app/api/agents/v1, con clave y secreto), Claude, OpenAI, Kimi |
| En línea, por configuración | Gemini, OpenRouter, xAI (Grok), DeepSeek, Mistral, Hugging Face Inference Providers |
| Pruebas y trabajo sin conexión | Un modelo falso con guion y predecible |
Tamaños que se ejecutan en tu computadora
| Tamaño | Modelo | Disco, aproximado | Memoria necesaria |
|---|---|---|---|
| XS | Gemma 4 E2B | 1.6 GB | 4 GB |
| S | Qwen3-4B-Instruct-2507 (el predeterminado de la plataforma) | 2.5 GB | 8 GB |
| M | Qwen3-8B | 5 GB | 12 GB |
| L | Qwen3-14B | 9 GB | 16 GB |
| XL | gpt-oss-20b | 12 GB | 16 GB |
Enrutamiento. Un sesgo de 0 a 100 define cuánto sale a internet: 0 es solo local, una prohibición total; 100 es solo en línea; cualquier valor intermedio es la probabilidad de que una llamada salga a internet. Cada rol puede tener su propio sesgo. Una llamada pasa al otro nivel solo ante fallos pasajeros, como un tiempo de espera agotado, un límite de frecuencia o un error del servidor, o cuando el prompt es demasiado largo. Una clave rechazada o una solicitud incorrecta se informa, y nunca se “arregla” enviando tu prompt a otro lugar.
Castas. A los roles también se les puede asignar una casta: la inferior es solo local, la intermedia es mitad y mitad, la de élite es solo en línea. Una casta prevalece sobre el sesgo de un rol, que a su vez prevalece sobre el sesgo general.
Lo que agrega Verse AI
Verse AI es la API de modelos propia de la plataforma, desde este sitio: OpenAI Chat Completions más lo que los agentes saben de cada llamada.
- Solo herramientas que puede usar
- La forma de la respuesta solo admite las herramientas que este agente tiene permitidas, con las entradas exactas de cada herramienta
- Piensa tanto como lo necesita el paso
- El esfuerzo de razonamiento sigue la profundidad del paso
- Reutiliza lo que ya leyó
- Una clave de caché para las instrucciones que repite cada paso
- Sabe quién pregunta
- Cada llamada indica su propósito, el rol del agente, la tarea y si debe quedarse en local
- Lo demasiado largo va a otro lado
- Un prompt demasiado largo para el modelo se envía al otro nivel en lugar de fallar
El modelo de respaldo
Cuando ni el modelo local ni uno en línea responden, Verse habla a través de un modelo pequeño que se ejecuta dentro de la app en tu tarjeta gráfica. No puede darles trabajo a los agentes, y se descarga en cuanto vuelve el modelo habitual.
| Modelo | Descargar | Memoria gráfica | Bueno para |
|---|---|---|---|
| Qwen2.5 0.5B (predeterminado) | 0.29 GB | 0.9 GB | El más rápido; bien para charla ligera, flojo con los datos |
| Llama 3.2 1B | 0.7 GB | 0.9 GB | Un poco más natural |
| Qwen2.5 1.5B | 0.88 GB | 1.6 GB | El mejor equilibrio |
| Llama 3.2 3B | 1.82 GB | 2.3 GB | Una tarjeta gráfica potente |
| Phi 3.5 mini | 2.15 GB | 3.7 GB | El mejor razonando, y el más pesado |
Al iniciar, la app calienta el modelo local antes de tu primera pregunta; hasta que está listo, Verse atiende por sí mismo los comandos y la charla ligera y dice que aún está despertando.
Memoria
Hay tres memorias separadas, además de las habilidades.
- Lo que Verse sabe de ti
- Un pequeño almacén vectorial solo en esta máquina. Un dato se conserva únicamente si la mayoría de sus palabras son cosas que dijiste en este turno o en el anterior, nunca si parece un secreto, y un casi duplicado actualiza el dato anterior en vez de agregar otro. Hasta seis datos relevantes llegan al modelo como evidencia, y Verse nunca los recita a menos que lo pidas.
- Lo que saben los agentes
- Memoria a largo plazo en seis espacios de nombres, con una única entrada: se comprueba de dónde viene, se eliminan duplicados, se revisan contradicciones y luego se retiene o se asciende. Un agente nunca puede ascender su propia memoria, y solo la memoria verificada llega a un modelo.
- El tablero compartido
- Lo que los agentes se dicen durante una tarea, con cada elemento puntuado para que los antiguos o inciertos se hundan.
- Habilidades
- Programas reutilizables con pruebas y una lista de permisos. Solo se pueden usar habilidades validadas o de confianza, y se ejecutan en el sandbox.
Aprobaciones y seguridad
Los agentes trabajan por su cuenta hasta que un paso cambiaría algo importante. Cada acción tiene un tamaño, y las suficientemente grandes te esperan. Cada cambio se comprueba; un cambio que no pasa la comprobación se deshace. Todo queda por escrito.
| Tamaño | En la app | ¿Puedo deshacerlo? | Nombre de la plataforma |
|---|---|---|---|
| Solo pensar | Nada que deshacer | cognitiveOnly | |
| Solo mirar | Nada que deshacer | readOnly | |
| Cambios que se pueden deshacer | Sí. Se puede revertir. | reversibleWrite | |
| Cambios que otros ven | No del todo. Otras personas lo verán. | significantSharedWrite | |
| No se puede deshacer | No. Una vez hecho, hecho está. | irreversibleOrHighImpact |
- Cuándo debe preguntar un agente: los dos últimos tamaños siempre esperan a una persona, y también todo lo que supere el límite del propio agente. Un modelo que suena seguro nunca puede bajar un tamaño ni saltarse una aprobación.
- Copiado de otro lugar: si una acción usa algo que viene de contenido no confiable, como una dirección de correo copiada de una página web y no de tu solicitud, “permitido” pasa a “preguntarte”.
- Lo que ata una aprobación: una huella de la acción exacta, sus argumentos, su destino, la herramienta y la autoridad del agente. Si algo de eso cambia antes de que se ejecute, se rechaza y el agente debe pedirla de nuevo. Las solicitudes caducan a las 24 horas.
Por lo que pasa cada acción
- Comprobar su forma
- Dimensionar el riesgo
- Reglas, rechazo por defecto
- Tu visto bueno, si hace falta
- Un permiso de un solo uso
- Pantalla de entrada
- Preparar
- Ejecutar, en sandbox o como transacción
- Pantalla de salida
- Comprobar el resultado de forma independiente
- Conservarlo o deshacerlo
- Anótalo
- Pantallas
- A la entrada: alineación con la tarea, tamaño de los argumentos, rutas que intentan escapar, direcciones web (las direcciones privadas y de metadatos de la nube se rechazan al conectar), secretos, alcance de SQL y límites de frecuencia. A la salida: se bloquean los secretos filtrados y las salidas demasiado grandes, y el texto que parece instrucciones inyectadas se marca como no confiable.
- Niveles de confianza
- Cada elemento de contexto lleva un nivel: 0 datos externos no confiables, 1 datos internos recuperados, 2 la observación de un agente, 3 tu instrucción, 4 la política del sistema. Solo los niveles 3 y 4 pueden ser instrucciones, y eso lo imponen los tipos del código, no pedírselo amablemente al modelo.
- Sandbox
- El código se ejecuta con una carpeta de trabajo aislada, un entorno limpio, sin red de forma predeterminada y con límites de recursos. El sandbox de contenedor (sin red, raíz de solo lectura, todas las capacidades retiradas) es un límite real en los tres sistemas operativos.
- Siempre activado
- No se permite nada a menos que una regla lo diga. Todo lo que no se puede deshacer te pregunta primero. Un agente que suena seguro igual tiene que preguntar.
El comando de terminal
verse-agent es Verse sin la ventana, en cualquier terminal. Necesita Node 22.18 o posterior y la plataforma compilada. Se llama verse-agent, no verse, para que nunca tape a otra herramienta.
| Comando | Qué hace |
|---|---|
verse-agent | La vista de pantalla completa: conversación, agentes y actividad en paneles |
verse-agent chat | Hablar línea por línea |
verse-agent say <words> | Di una cosa e imprime la respuesta |
status agents tasks approvals health models | Responde y sale; agrega --json para scripts |
verse-agent task <agent> <goal> | Darle una tarea a un agente |
verse-agent approve [n], deny [n] | Decide. Aprobar te pide confirmar, y los dos tamaños más grandes requieren escribir “yes” completo. |
verse-agent cancel <task>, history <task> | Detener una tarea, o repetirla con sus comprobaciones de seguridad |
rules tools skills memory | Lo que los agentes pueden hacer, sus herramientas, lo que aprendieron, lo que saben |
verse-agent connections | Listarlos, activar o desactivar uno, guardar una clave (se escribe oculta y luego se sella), dar o quitar uno a un agente |
verse-agent me | Lo que Verse sabe de ti; recordar u olvidar |
verse-agent models use <provider> <model> | Elegir el modelo en línea y cuánto se envía a internet |
verse-agent handbook, search <words> | El manual en la terminal |
verse-agent serve | Una plataforma compartida por todas las terminales |
verse-agent tmux | Una sesión de tmux con tema, o paneles integrados donde falta tmux |
En el chat, empieza una línea con @scribe para darle trabajo al escriba. Los paneles se dividen como en tmux: pulsa Ctrl+B, suelta, y luego % divide en paralelo y " de arriba abajo. Cuando un agente necesita tu visto bueno, se abre solo un panel Te necesita sin quitarte lo que estás escribiendo.
Actualizaciones y distribución
- La plataforma se distribuye como paquetes con versión y sumas de comprobación: diez paquetes NuGet, zips ejecutables de la API y del worker (necesitan el runtime de .NET 10), una wheel y un sdist de Python, y un paquete npm. Cada uno se prueba con una prueba de humo, tal como lo instalaría un consumidor.
- Contenedores: imágenes separadas de API y de worker sin privilegios de root, y un archivo compose con PostgreSQL, OPA, un recolector de OpenTelemetry y un modelo de relleno.
- Verse Agent tiene instaladores para Windows (una sola cuenta, con
verse-agenten su PATH) y Linux (un .deb y un AppImage). Incluyen la app, el comando de terminal, la plataforma compilada con el runtime de .NET incluido y los instaladores de Verse Node, cerca de 1 GB en total. - Verse Node tiene instaladores propios para Windows (para todas las cuentas, con una regla de Windows Firewall solo para redes privadas) y Linux (un .deb y un AppImage), de unos 140 a 180 MB cada uno.
- No hay instalador para macOS, los instaladores todavía no tienen firma de código y nada se actualiza solo: ejecuta el instalador más reciente o descarga el código fuente y vuelve a compilarlo. Desde el código fuente funciona igual que antes:
npm install(que también descarga los modelos de voz, audición y memoria),npm run platform:build, y luegonpm start. Descárgalos en Descargas más abajo.
Cómo funciona
Un modelo central, muchos agentes acotados y una única puerta entre cualquier decisión y su efecto.
Las piezas y cómo se comunican
Verse Agent (Electron 44)
Proceso principal
- Inicia, vigila y reinicia la plataforma
- El compañero: memoria, luego modelo, luego aprendizaje
- La memoria que Verse tiene de ti
- Claves y conexiones selladas
solo mensajes validados
La ventana, en sandbox
- El cristal o el osciloscopio
- Voz y oído, cada uno en un worker
- Compañero, narrador y libro de frases
- El centro de mando y el manual
- El modelo de respaldo en la tarjeta gráfica
HTTP local en 127.0.0.1, con una clave nueva en cada inicio
Una transmisión en vivo de cada paso
La plataforma de agentes (.NET 10)
AgentPlatform.Api
- REST bajo
/api/v1 - El worker de tareas
- El ciclo del agente y la puerta de acciones
- Política, herramientas, memoria, habilidades
- El runtime del modelo, local o en línea
- Servidores MCP
llamadas al modelo
Modelos
Ollama, llama.cpp, vLLM, Verse AI, Claude, OpenAI, Kimi y otros
- La app inicia la plataforma en un puerto local con una clave nueva de 48 caracteres que nunca muestra a la ventana, desactiva la clave de desarrollo incluida y reinicia una plataforma que falla hasta tres veces.
- La ventana nunca ve la clave ni el puerto. Cada llamada es un mensaje que solo se acepta desde la propia página de la app, con ids verificados y texto limitado a 2,000 caracteres.
- El comando
verse-agentejecuta el mismo código de supervisor y de compañero en Node simple, o se conecta a unverse-agent serveen ejecución. - Verse Node en otra computadora se conecta a un hub en el proceso principal de la app mediante un WebSocket cifrado. La plataforma entrega a un nodo su paso a través de una puerta en 127.0.0.1, con un token nuevo en cada inicio.
Un modelo central, muchos agentes acotados
Un modelo central grande coordina a muchos agentes más pequeños. Cada uno tiene autonomía acotada, un estado tipado, un planificador de corto alcance, memoria local, sus propias herramientas, una estimación de su propia incertidumbre, comprobaciones de su trabajo y una forma de pedir ayuda. Lo que devuelve un modelo es siempre una decisión analizada de forma estricta: actuar, revisar el plan, terminar o escalar. El modelo nunca llama a una herramienta.
La solución de C# tiene trece proyectos de código, incluido el comando del arnés, más cuatro proyectos de pruebas y tres ejemplos, con límites estrictos: la lógica central nunca hace referencia a un SDK de modelos, una biblioteca de bases de datos, un framework web ni un motor de flujos de trabajo.
El ciclo
- Mirar
- Actualizar creencias
- Plan
- Proponer una acción
- Validar
- Autorizar
- Ejecutar
- Comprobar
- Actualizar el estado
- Guardar un punto de control
- Continuar, terminar o escalar
- Los presupuestos de pasos, llamadas a herramientas, tokens y tiempo son estrictos. Una llamada al modelo solo se deja pasar si su respuesta aún cabe, y un ayudante recibe como máximo lo que le queda a su padre.
- Repetir la misma propuesta, o no avanzar, se detecta y detiene la ejecución.
- Un trabajo se da por terminado solo cuando se cumplen todas las metas verificables por máquina. Un cierre incorrecto o un plan incorrecto se devuelve, y el rechazo queda registrado.
- Antes de enviar una acción, se guarda la decisión. Tras un fallo se concilia: un resultado registrado se reutiliza, una acción que comprobadamente nunca salió se reenvía, y todo lo desconocido se detiene a la espera de una persona. Un efecto secundario que pudo haber ocurrido nunca se reintenta.
La puerta de acciones
El único camino de una decisión a un efecto real. Cada etapa puede decir que no, y no es lo predeterminado.
- Los ids de las propuestas los genera el runtime, nunca se toman del modelo, y una propuesta se ejecuta como máximo una vez.
- Una herramienta que puede deducir su destino real a partir de sus argumentos reemplaza la etiqueta del modelo antes de cualquier comprobación. Una herramienta que cambia algo y no puede hacerlo se rechaza.
- Todo lo que sale mal después de preparar el cambio se revierte exactamente una vez, en 30 segundos. Una reversión que falla se informa como tal.
- Dos escrituras sobre lo mismo a la vez fallan rápido. El historial real de cada agente alimenta lo arriesgadas que parecen sus acciones.
Tareas, transiciones y puntos de control duraderos
Las tareas se aceptan una vez por clave, se reintentan con retroceso (tres intentos de forma predeterminada), se apartan tras fallos repetidos y se aparcan mientras esperan una aprobación. Una aprobación se decide exactamente una vez, y entonces la tarea se reanuda desde su punto de control. Cada transición se guarda, en orden, y nunca se reescribe.
Los puntos de control llevan una versión que funciona como token de vallado: de dos trabajadores que reanudan la misma tarea, solo puede actuar aquel cuyo punto de control se registra. Verse lee los registros propios de la plataforma de las últimas diez tareas que puedes ver, así que cuando preguntas “¿Qué salió mal?” responde con el paso que falló y el error exacto, en palabras sencillas, y nunca adivina.
Cada tipo de transición y cómo la muestra la app
| Tipo | Significado | En la app |
|---|---|---|
TaskAccepted | Una ejecución comenzó | “Inició: …” |
PlanCreated | Se hizo un plan | “Hizo un plan” |
ActionProposed | Se eligió una acción | Un paso de la repetición: “Usó …” |
PolicyDecision | Las reglas decidieron | “Una regla bloqueó lo que intentó” (solo rechazos) |
ApprovalRequested, ApprovalDecision | Esperando a una persona, y luego decidido | “Necesita tu visto bueno”, luego “Aprobaste” o “Dijiste que no” |
ToolExecutionStarted, ToolExecutionCompleted | La herramienta se ejecutó y terminó | “Usando …”, o “Ese paso falló.” |
VerificationCompleted | El resultado se comprobó | “El resultado no pasó la revisión” (solo fallos) |
StateCommitted, RollbackCompleted | Conservado o deshecho | “Lo deshizo. No cambió nada” |
EscalationRaised | Le preguntó al modelo central | “Pidió una segunda opinión al modelo principal” |
ActionReconciled | Una acción interrumpida se comprobó al reanudar | “Revisó un paso que se cortó” |
StepRejected | El ciclo rechazó un paso | “Rehaciendo un paso: dijo que estaba listo, pero la meta aún no se cumple” |
TaskAttemptFailed | Una ejecución falló y se reintentará | “Falló y lo intentará de nuevo” |
TaskCompleted, TaskFailed, TaskCancelled, TaskDeadLettered | El final | “Terminó”, “Detenido”, “Cancelado”, “Se rindió tras varios intentos” |
La API de la plataforma
Todas las rutas están bajo /api/v1, requieren una clave de operador o de aprobador y tienen límite de frecuencia por clave (120 solicitudes por minuto de forma predeterminada). Los objetos de otro inquilino responden “no encontrado”, para que los ids no se filtren.
Cada ruta que la app llama una por una
| Ruta | Se usa para |
|---|---|
GET /health/live, /health/ready | Estado del sistema, y la espera al iniciar |
GET /events | Una transmisión en vivo de transiciones; un lector lento nunca frena a un agente |
GET /agents | La lista de agentes, con herramientas, límites, presupuesto y ubicación de los datos |
POST /companion/reply | Un turno de conversación |
POST /tasks, GET /tasks/{id}, /state, /transitions, /audit, /progress | Dar trabajo, seguirlo, repetirlo, auditarlo |
POST /tasks/{id}/cancel | Cancelar |
GET /approvals, POST /approvals/{id} | Aprobaciones en espera; decidir requiere el rol de aprobador |
GET /workspace | El tablero compartido |
GET /agents/{id}/memories, POST /memories/{id}/promote, /reject | Revisar lo que guardaron los agentes |
GET /tools, /policies, /skills, /connections | Vistas de solo lectura para esas ventanas |
GET /prompt-skills, PUT /prompt-skills/{name}, DELETE /prompt-skills/{name} | Tus habilidades: listar, guardar, eliminar |
GET /collectives, PUT /collectives/{name}, DELETE /collectives/{name} | Colectivos y sus tableros; al guardar se comprueba el tablero, y se rechaza eliminar uno que otro colectivo usa |
POST /collectives/{name}/runs | Iniciar la ejecución de un colectivo |
POST /agents | Crear un agente, con una regla de permiso por herramienta |
POST /a2a | Un punto de conexión opcional de agente a agente |
Un turno de conversación, de principio a fin
- Hablas o escribes. Moonshine convierte la voz en una línea, y la app comprueba si es un comando. Los comandos se atienden de inmediato.
- En los demás casos, la ventana envía tu mensaje, los últimos 12 turnos y la actividad reciente. El proceso principal recuerda hasta seis datos sobre ti y le pide una respuesta a la plataforma.
- La plataforma construye el contexto del modelo: la personalidad y las reglas de habla como política del sistema, tu mensaje como tu instrucción, la conversación y los datos recordados como datos, y el trabajo de los agentes como observaciones. Pasa por el mismo runtime de modelos que los agentes, así que se aplican la misma elección de modelo y las mismas reglas de privacidad.
- La respuesta lleva lo que hay que decir, hasta cinco datos para recordar, hasta dos temas y, opcionalmente, un trabajo para un agente, que se convierte en una tarea real.
- Los datos propuestos se comparan con lo que dijiste antes de guardarse.
- La ventana acorta la respuesta para la voz y la pronuncia.
Ubicación de los datos
Un estatuto, una tarea o la salida de una herramienta pueden marcar datos como solo locales. Una ejecución toma la más estricta de las tres y la mantiene: en cuanto se ve una salida solo local, todas las llamadas posteriores de esa ejecución se quedan en local. El trabajo solo local va únicamente a modelos locales, nunca en línea: ni como respaldo, ni por el sesgo, ni para una segunda opinión, y se rechaza cuando no existe ningún modelo local. En la app esto es Mantener lo privado aquí, que siempre está activado.
Seguridad y claves
- La app
- La ventana está en sandbox, sin acceso a Node y con un puente mínimo que nunca expone la clave de la plataforma. Sin ventanas emergentes, sin navegar a otro sitio, con una política estricta de seguridad de contenido y con todos los permisos denegados excepto el micrófono.
- Claves de modelos
- Cifrada por el sistema operativo (DPAPI en Windows, el Llavero en macOS, GNOME Keyring o KWallet en Linux), guardada solo para su propietario y atada a esa carpeta y a esa cuenta, así que una copia en otro lugar no se puede leer. La dirección del servidor se sella junto con la clave, así que editar un archivo no puede redirigirla. La ventana solo ve los últimos cuatro caracteres.
- Con claridad
- Un programa que ya se ejecuta como tú puede pedirle al sistema operativo que descifre. El cifrado protege el archivo en reposo: copias, respaldos, otras cuentas y otras computadoras.
- La plataforma
- Política de rechazo por defecto que falla cerrada, niveles de confianza estructurales, permisos de un solo uso, filtros a la entrada y a la salida, reversión transaccional, memoria retenida para revisión, bloqueos, ejecuciones idempotentes, una auditoría de solo anexado, definiciones MCP fijadas y aprobaciones atadas a la acción exacta. Sin credenciales predeterminadas en producción.
Persistencia y observabilidad
- La plataforma guarda sus registros en PostgreSQL en producción, en SQLite en las pruebas o en memoria durante el desarrollo. Las filas de auditoría, de transiciones y de uso son de solo anexado.
- En la app Verse Agent la plataforma guarda sus registros en memoria. Las tareas, el historial, las aprobaciones, las memorias de los agentes y el tablero compartido duran solo mientras la plataforma está en marcha, y empiezan vacíos después de un reinicio, incluidos los reinicios que siguen a un cambio de modelo, de clave o de conexión. La memoria que Verse tiene de ti, las claves guardadas, los interruptores de conexión y la configuración están en el disco y se conservan.
- Los spans y las métricas de OpenTelemetry llevan solo ids, tamaños y hashes. La app desactiva la telemetría.
- Evaluación: ejecuciones grabadas que se reproducen sin efectos secundarios, pruebas de inyección al estilo de AgentDojo (éxito de ataque medido: 0), pruebas de uso de herramientas y 46 comprobaciones de inyección de fallos comparadas en los tres lenguajes.
Dónde vive todo en tu computadora
| Qué | Dónde |
|---|---|
| La elección del modelo | platform/model-config.json |
| Agentes y sus reglas | platform/agents.json |
| Conexiones tal como se entregan | platform/mcp-servers.json |
| Notas que escribe el escriba | Documents/Verse Notes |
| Tu carpeta de perfil | Windows %APPDATA%/Verse Agent, macOS ~/Library/Application Support/Verse Agent, Linux ~/.config/Verse Agent |
| La memoria que Verse tiene de ti | companion/memory.json en la carpeta del perfil |
| Claves de modelos guardadas | credentials.json en la carpeta del perfil, cifrado |
| Interruptores de conexión y claves | connections.json en la carpeta del perfil, cifrado |
| Tus habilidades y colectivos | skills.json y collectives.json en la carpeta del perfil |
| Nodos emparejados | nodes.json en la carpeta del perfil, cada secreto sellado por el sistema operativo |
| Los archivos propios de un nodo | En esa computadora: Windows %APPDATA%/Verse Node, Linux ~/.config/verse-node |
| Configuración de la terminal | cli/settings.json en la carpeta del perfil |
| El modelo de respaldo | El almacenamiento propio del navegador de la app |
Tres lenguajes, un comportamiento
La plataforma en C# es la referencia. La versión de Python (3.11 o posterior, solo biblioteca estándar) y la de Node.js (TypeScript, Node 18 o posterior, sin dependencias en tiempo de ejecución) son copias fieles, probadas de forma independiente, de todo el núcleo: el ciclo, la puerta, los filtros, la política y los permisos, la memoria, las habilidades, la orquestación, cada proveedor de modelos y MCP. Comparten un solo formato de configuración, una sola política, los mismos vectores de prueba y las mismas comprobaciones de inyección de fallos. La app Verse Agent ejecuta la compilación en C#.
Especificaciones y descargas
Versiones, cantidad de pruebas y los comandos para compilarlo tú mismo.
Tecnologías y versiones
| Parte | Hecho con |
|---|---|
| Plataforma | .NET 10 (LTS) y C# 14, ASP.NET Core minimal APIs, EF Core 10 (SQLite, PostgreSQL), Polly, OpenTelemetry, FluentValidation. Pruebas con xunit v3, AwesomeAssertions, NSubstitute y Testcontainers. |
| Versión para Python | Python 3.11 o posterior, solo biblioteca estándar; pytest |
| Versión para Node | TypeScript ESM, Node 18+, sin dependencias en tiempo de ejecución; vitest |
| App Verse Agent | Electron 44.5.1, TypeScript 7, Vite 8, Preact 11, three.js 0.186 con posprocesamiento, onnxruntime-web 1.30, Moonshine WASM, WebLLM 0.2.85 |
verse-agent comando | TypeScript ejecutado directamente por Node 22.18+ |
| Verse Node | JavaScript simple ejecutado por su propio Electron 44.5.1, ws 8.18.3, node:crypto solo para el protocolo, y la plataforma de C# autocontenida |
| Empaquetado | electron-builder 26.15.3 (NSIS en Windows, .deb y AppImage en Linux), y dotnet publish autocontenido para cada sistema |
| Modelos en el dispositivo | Kitten TTS mini v0.8 (78 MB más 3.3 MB de voces), Moonshine v2 medium (305 MB), bge-small-en-v1.5 (34 MB) |
| Versiones | Plataforma 1.1.1; app 0.1.0 |
Sistemas operativos
La plataforma se ejecuta en Linux, macOS y Windows, y su CI compila y prueba en las tres. Verse Agent se ejecuta en las tres a través del Chromium de Electron. En Linux, el modelo de respaldo necesita VERSE_WEBGPU=1 y guardar claves requiere GNOME Keyring o KWallet; en macOS hay que permitir el micrófono; las terminales de Windows no tienen tmux, así que verse-agent tmux usa sus paneles integrados. Los instaladores se crean solo para Windows y Linux. Verse Node tiene instaladores para Windows (x64) y Linux (.deb y AppImage x64); una Mac ejecuta un nodo desde un repositorio clonado.
Pruebas
| Suite | Pruebas | Omisiones permitidas |
|---|---|---|
| Unitarias en C# | 638 | 1 |
| Seguridad en C# | 55 | 0 |
| Integración en C# | 95 | 4: tres pruebas de PostgreSQL que necesitan Docker, una prueba con Ollama en vivo |
| Trayectoria en C# | 3 | 0 |
| Python | 533 | 1 |
| Nodo | 532 | 1 |
| Inyección de fallos, por lenguaje | 46 comprobaciones | La comprobación de contenedores, sin Docker |
| Verse Agent | 191 | 1, una prueba de permisos de archivo omitida en Windows |
Compilar y ejecutar
| Hacia | Ejecutar |
|---|---|
| Compilar y probar la plataforma | dotnet test (no necesita nube, modelo ni base de datos) |
| Ejecutar la API | dotnet run --project src/AgentPlatform.Api |
| La pila local completa | docker compose up -d |
| Un modelo local real | ollama pull qwen3:4b-instruct-2507 |
| Pruebas de Python y Node | cd python && python -m pytest -q, cd nodejs && npm test |
| Comparar los tres lenguajes | python scripts/harness_compare.py --iterations 200 |
| Instalar la app | npm install (descarga voz 82 MB, oído 305 MB, memoria 34 MB) |
| Compilar la plataforma de la app | npm run platform:build (requiere el SDK de .NET 10) |
| Ejecutar la app | npm run dev o npm start |
| Probar la app | npm test, npm run typecheck |
| Los instaladores de la app | npm run dist (este sistema), npm run dist:linux (desde Windows, a través de WSL2) |
| Instaladores de Verse Node | npm run dist:node, npm run dist:node:linux |
| Todo lo que se delega | npm run deploy:all (primero los instaladores del nodo, luego los paquetes de la app y de la plataforma, con sumas de comprobación) |
Interruptores de entorno para Verse Agent
| Variable | Efecto |
|---|---|
VERSE_USER_DATA | Otra carpeta de perfil para la memoria, las claves, las conexiones y los archivos de la terminal |
VERSE_NOTES_DIR | La carpeta de notas de los agentes |
VERSE_MODEL_CONFIG, VERSE_AGENTS_FILE, VERSE_MCP_SERVERS | Archivos de otro modelo, agentes y servidores |
VERSE_NO_PLATFORM=1 | No iniciar la plataforma de agentes |
VERSE_DISABLE_GPU=1 | Renderizado por software |
VERSE_WEBGPU=1 | Activar WebGPU en Linux, para el modelo de respaldo |
VERSE_THEME=dark o light | Reemplazar el tema del sistema para el manual |
VERSE_FAKE_MIC=<wav> | Usar una grabación como micrófono, para pruebas |
VERSE_SKIP_MODEL_FETCH=1 | Omitir la descarga de modelos durante la instalación |
VERSE_DEBUG=1, NO_COLOR | Registro de la terminal, y sin color |
VERSE_NODES_FILE | Guardar los nodos emparejados de Verse en otro archivo |
VERSE_NODE_HOME, VERSE_NODE_PLATFORM | La carpeta de un nodo, y un nodo que se ejecuta con la compilación de la plataforma de un repositorio clonado |
Descargas
Verse Agent 0.1.0, Verse Node 0.1.0 y la versión publicada 1.1.1 de la plataforma: las versiones que describe esta página. Verifica cualquier descarga con SHA256SUMS.txt.
La licencia en breve: gratis para uso personal y comercial, así que construye y vende lo que quieras con ella, pero no puedes presentar la plataforma como tuya ni revenderla ni redistribuirla como tu propio producto o servicio administrado.
Verse Agent la aplicación y el comando verse-agent
Para Windows 10 u 11 y Linux de 64 bits. No hay nada más que instalar: la plataforma de agentes incluida es autocontenida. Todavía no hay instalador para Mac; en una Mac, ejecútalo desde una copia del repositorio (consulta Compilar y ejecutar más arriba).
Windows: ejecuta el instalador. Se instala solo para tu cuenta y agrega verse-agent a tu PATH (abre una terminal nueva para usarlo). Todavía no tiene firma de código, así que SmartScreen pide confirmación primero: elige Más información y luego Ejecutar de todos modos.
Linux: instala el .deb y luego abre Verse desde el menú de Aplicaciones. En cualquier otra distribución, vuelve ejecutable el AppImage y ejecútalo.
sudo apt install ./verse-agent_0.1.0_amd64.deb
verse-agent-desktop # the app
verse-agent agents # the terminal command
# or the AppImage, on any distribution
chmod +x Verse-Agent-0.1.0-x86_64.AppImage
./Verse-Agent-0.1.0-x86_64.AppImage
./Verse-Agent-0.1.0-x86_64.AppImage --cli agents
Verse se comunica a través de gemma3:1b en Ollama de forma predeterminada (ollama pull gemma3:1b), o elige un modelo en línea en la ventana de Modelos.
Verse Node otra computadora que ejecuta agentes para Verse
Instálalo en una segunda computadora de tu red y ábrelo; luego vincúlalo desde Verse (Agentes, Colectivos, Abrir el tablero, Agregar nodo) con el código de 12 caracteres que muestra. Los instaladores de Verse Agent también los incluyen, así que Verse puede guardarlos por ti.
Windows: el instalador es para todas las cuentas, así que pide derechos de administrador una vez. Permite a Verse pasar por el Firewall de Windows solo en redes privadas y agrega verse-node al PATH.
sudo apt install ./verse-node_0.1.0_amd64.deb
verse-node status # the terminal command; the AppImage takes --cli status
# if ufw is on
sudo ufw allow 47800/tcp && sudo ufw allow 47801/udp
C# y .NET csharp/
Requiere el runtime de .NET 10, o el SDK para desarrollar.
Descomprime los paquetes NuGet, agrega la carpeta como origen de paquetes e instala:
# point NuGet at the unzipped folder
dotnet nuget add source /path/to/downloads/csharp/nuget --name agentplatform
dotnet add package AgentPlatform.Infrastructure
El zip de la API es el servicio REST: descomprímelo y ejecuta dotnet AgentPlatform.Api.dll. El estado de salud está en GET /health/live, la API está bajo /api/v1 con una X-Api-Key, y se configura mediante appsettings.json o el entorno. El zip del worker es el ejecutor de tareas en segundo plano: dotnet AgentPlatform.Worker.dll. Ambos incluyen un ejemplo de configuración de modelo y el catálogo de modelos locales.
Python python/
Requiere Python 3.11 o posterior, sin otras dependencias.
pip install agent_platform-1.1.1-py3-none-any.whl
python -c "import agent_platform; print(agent_platform.__version__)"
Node.js y TypeScript nodejs/
Requiere Node 18 o posterior, sin dependencias en tiempo de ejecución. ESM, con declaraciones de TypeScript.
npm install agent-platform-1.1.1.tgz
Cada compilación funciona sin conexión desde el primer momento, con almacenes en memoria y un modelo con guion: no hacen falta claves de API ni base de datos para probarla.
Glosario las palabras usadas en esta página y en la app
- Agente
- Un trabajador con una sola tarea, un conjunto de herramientas, un presupuesto y reglas, como el escriba
- Estatuto
- La descripción de puesto de un agente: para qué sirve, sus herramientas, límites, cuándo preguntar, qué puede recordar y dónde puede pensar
- Tarea
- Un trabajo concreto que se le da a un agente. Puede pasar partes a ayudantes.
- Paso
- Un turno del ciclo: mirar, pensar, actuar
- Presupuesto
- Límites estrictos de pasos, usos de herramientas, tokens y tiempo
- Tamaño del cambio
- 0 solo pensar, 1 solo mirar, 2 cambios que se pueden deshacer, 3 cambios que otros ven, 4 no se puede deshacer
- Visto bueno
- El sí o el no de una persona para una acción exacta
- Mantener para aprobar
- Un botón que se mantiene presionado 1.2 segundos, para que un clic accidental nunca apruebe
- Puerta de acciones
- El único camino de la decisión de un modelo a un efecto real: comprueba, ejecuta, verifica, revierte y registra
- Regla
- Un permitir o denegar para un rol, una acción y un recurso, hasta cierto tamaño
- Permiso
- Un pase de corta duración y de un solo propósito, emitido tras la autorización y consumido de inmediato
- Pantallas
- Comprobaciones de la entrada de una herramienta (rutas, direcciones, secretos, SQL) y de su salida (secretos, tamaño, instrucciones inyectadas)
- Sandbox
- Dónde se ejecuta el código aislado; un contenedor es un límite real
- Reversión
- Deshacer un cambio preparado que no pasó la comprobación
- Segunda opinión
- Un agente que le pide ayuda al modelo central con un breve resumen de dónde está
- Modelo central y local
- El nivel en línea más grande, y el nivel de este dispositivo
- Sesgo
- Cuánto del trabajo va al modelo central, en total o por rol
- Solo local
- Una marca que mantiene los datos en modelos locales durante el resto de una ejecución
- Transición
- Un evento registrado en la vida de una tarea
- Punto de control
- Una copia guardada del estado de un agente, para que una tarea se reanude tras un reinicio
- Nivel de confianza
- Cuánto se confía en un elemento de contexto, desde datos externos no confiables (0) hasta la política del sistema (4)
- Tablero compartido
- Lo que los agentes se dicen durante las tareas, ordenado por importancia
- En espera
- Una nota que guardó un agente y que nadie ha revisado todavía
- Habilidad aprendida
- Un programa reutilizable y probado que un agente aprendió o recibió
- Tu habilidad
- Instrucciones que escribes una vez y activas para una solicitud con
/name. Acompañan a cualquier trabajo que se delegue. - Colectivo
- Un equipo de agentes y colectivos más pequeños que atiende una solicitud en conjunto, que se pide con
@name - Tablero
- Donde se dibuja el equipo de un colectivo, como un panel de conexiones: módulos conectados con cables, con Verse arriba. Solo los cables tienen significado.
- Módulo
- Un lugar en un tablero: un agente, un colectivo o un nodo
- Nodo
- Otra computadora de tu red que ejecuta Verse Node, su propia plataforma de agentes. En un tablero, un círculo con los agentes que se ejecutan allí debajo.
- Código de emparejamiento
- El código de 12 caracteres que muestra un nodo, escrito una vez en Verse para emparejarlos
- Retransmisor
- El camino que siguen las llamadas a modelos de un nodo de vuelta a Verse, que agrega la clave, de modo que las claves nunca salen de la computadora principal
- MCP
- Model Context Protocol, el estándar para conectar servidores de herramientas externos
- Conexión
- Un servidor MCP activado en la app
- Acción de cambio
- Una herramienta de conexión que cambia algo por ti: vista previa, aprobación, aplicación
- A2A
- El protocolo de agente a agente, para llamar o exponer agentes entre sistemas
- OPA
- Open Policy Agent, un motor de políticas externo opcional
- Narración
- Lo que Verse dice sobre el trabajo de los agentes, del libro de frases
- Muse
- Verse sacando un tema por su cuenta mientras los agentes trabajan
- Fósforo y tubo
- El esquema de color CRT: verde P1, azul P7, ámbar P3, blanco P4
- Modelo de respaldo
- Un modelo pequeño dentro de la app, en la tarjeta gráfica, para cuando nada más responde
- Verse AI
- La API de modelos propia de la plataforma, autoalojada o en verse-realm.app
- VXT
- El crédito en el que cobra el servicio alojado de Verse AI