Skip to content

README.es.md

Latest commit

 

History

History
124 lines (84 loc) · 7.59 KB

README.es.md

File metadata and controls

124 lines (84 loc) · 7.59 KB
Raw

Browser Agent v86 POC

English | Español

Versión beta

Browser Agent v86 POC ejecuta una VM Linux x86 con v86, un chat con LLM desde el navegador y herramientas de agente que pueden lanzar comandos dentro de la VM. El objetivo es experimentar con IA local, Linux, automatización y red desde una aplicación web servida como archivos estáticos.

Estado actual: beta 0.9.8-beta.6. La versión 1.0.0 queda reservada para la primera publicación estable.

Qué incluye

  • VM Alpine x86 en el navegador: arranque por initramfs, perfiles generados y discos HDA opcionales como discos de datos.
  • Consolas xterm directas: hasta 4 pestañas de usuario; la pestaña 1 usa serial0 real y las pestañas 2-4 usan PTY propia dentro de la VM.
  • Tools de agente en background: comandos del chat y checks por serial1 / /dev/ttyS1, separados de la consola visible.
  • Transporte de consola dedicado: multiplexado xterm/PTY por serial2 / /dev/ttyS2 para las pestañas 2-4.
  • Runners guest en Python 3: los perfiles VM incluyen python3 como dependencia base del overlay serial.
  • LLM en navegador u Ollama local: Transformers.js con WebGPU/WASM y provider Ollama HTTP opcional, con visualización opcional del razonamiento (thinking) configurable por modelo.
  • Red opcional vía wsnic: proxy WebSocket local para dar salida de red a la VM.
  • UI bilingüe ES/EN: selector de idioma en la cabecera con cambio en caliente (sin recargar ni perder la VM); si no hay una preferencia guardada, la app elige español cuando el navegador declara algún idioma español e inglés en caso contrario.

Probar la demo online

La forma más rápida de probar el proyecto es abrir:

https://browseragent.icu/

Antes de probar la demo, se recomienda leer el manual de usuario.

La demo no requiere clonar el repo. Los modelos Transformers.js se descargan y ejecutan desde tu navegador. Ollama y wsnic son opcionales y, si los usas, se ejecutan localmente en tu equipo.

Ejecutar desde el repo

Requisitos principales: Node.js 18+, Linux (o macOS con herramientas de build compatibles con GNU), Docker, herramientas de sistema para generar initramfs/discos y conexión a Internet para descargar assets base, paquetes Alpine y los modelos de navegador cuando se cargan por primera vez.

En Debian/Ubuntu, instala las dependencias de sistema con:

sudo apt install -y cpio gzip tar curl zstd xz-utils coreutils e2fsprogs findutils gawk grep sed

Memoria/GPU orientativa: mínimo 4 GB RAM; 8 GB RAM y GPU WebGPU con ~2 GB VRAM/memoria compartida para LLM local en navegador; más RAM/VRAM mejora la estabilidad. Detalles en docs/USAGE.es.md.

git clone https://github.com/Len4m/browser-agent-v86-poc.git
cd browser-agent-v86-poc
npm install
npm run prepare:local
npm start

Abre http://127.0.0.1:5173/.

Primer uso recomendado:

  1. Selecciona el perfil de VM.
  2. Pulsa Arrancar VM y espera a que aparezca la shell; la primera vez puede descargar assets grandes.
  3. Si el navegador acepta WebGPU, carga un modelo Transformers.js u Ollama desde el panel LLM. Con solo WASM, para agente/tools suele ser mejor usar Ollama o probar otro navegador/equipo con WebGPU.
  4. Usa el chat para pedir acciones dentro de la VM, o las consolas para comprobar y ejecutar manualmente.
  5. Si necesitas red en la VM, configura wsnic desde Red WS.

Puedes pulsar Comprobar en cualquier momento para revisar el estado de la app, VM, assets, red y tools.

El detalle de requisitos, scripts, empaquetado y solución de problemas está en docs/USAGE.es.md.

Ejecutar un runtime ya generado

Si ya tienes un zip de public/ con los assets generados, no necesitas Node.js ni Docker para usar la aplicación. Sirve esa carpeta con un servidor HTTP que envíe:

  • COOP/COEP/CORP para SharedArrayBuffer.
  • MIME correcto para .wasm.
  • Soporte Range para assets grandes.

No abras index.html como file://. npm start ya sirve public/ con las cabeceras necesarias.

Estructura principal

public/             # raíz servida al navegador; contiene salidas generadas y assets estáticos
data/               # catálogo de modelos y datos estructurados usados por el build
src/browser/        # código TypeScript del frontend
src/web/            # plantilla HTML y CSS fuente
scripts/            # scripts principales y pasos internos de build/setup/check/clean
tests/              # tests Node/unitarios de módulos browser y comportamiento del repo
vm/profiles/        # perfiles Alpine de VM
vm/overlay/common/  # runners y ficheros incluidos en el initramfs
docs/               # documentación de usuario, uso, arquitectura y desarrollo

Documentación

Documento Contenido
README.es.md Entrada al repositorio (este fichero).
docs/USER_MANUAL.es.md Manual de uso de la aplicación (VM, chat, paneles); sin instalación ni desarrollo.
docs/USAGE.es.md Instalación local, VM/LLM/wsnic, scripts, runtime zip y problemas habituales.
docs/ARCHITECTURE.es.md Arquitectura frontend, build, VM, seriales, LLM, contratos tools/perfiles y reglas de mantenimiento.
docs/VM_PROFILES_AND_TOOLS.es.md Guía de desarrollo para añadir perfiles VM y exponer tools mediante la política del perfil.
docs/schema-reference/ Referencias de campos generadas desde JSON Schema (catálogo LLM, perfil VM; en inglés).

Cada documento enlaza con su versión en el otro idioma. Para contribuir o desplegar el proyecto, usa USAGE, ARCHITECTURE y VM_PROFILES_AND_TOOLS. Para la semántica de campos de perfiles y catálogo LLM, consulta docs/schema-reference/.

Colaborar

Se agradece cualquier tipo de colaboración: issues, informes de bugs, ideas, traducciones, mejoras de documentación, pull requests y nuevos perfiles VM o tools de perfil. Si quieres añadir capacidades al runtime, consulta la guía de perfiles VM y tools.

Si el proyecto te resulta útil o interesante, dejar una estrella en el repositorio ayuda a que otras personas lo descubran.

Licencia

El código propio de Browser Agent v86 POC se publica bajo licencia MIT. Consulta LICENSE.

El runtime incluye o descarga componentes de terceros con sus propias licencias. Hay un resumen en THIRD_PARTY_NOTICES.txt.

Dependencias principales de terceros:

  • v86: BSD-2-Clause.
  • @browser-ai/transformers-js, @huggingface/transformers y AI SDK (ai): Apache-2.0.
  • Los perfiles Alpine generados pueden contener paquetes con licencias GPL, LGPL y otras licencias por paquete. Al redistribuir initramfs, imagenes o perfiles generados hay que conservar los avisos correspondientes y cumplir sus obligaciones.
  • Los modelos LLM descargados por el usuario desde Hugging Face, Ollama u otros origenes mantienen sus propias licencias y no pasan a estar cubiertos por la licencia MIT de este repositorio.