Skip to content

About

Project Repository for team-36 at Platanus Hack 26: Santiago ft. Buk

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Chameleon

Chameleon

Los sitios web están hechos para el promedio. Chameleon los adapta para que cualquiera logre lo que vino a hacer.

Una extensión de navegador aplica un tema sobre cada página, sin tocar el sitio original. El tema sale de agentes de IA que recorren el sitio como lo haría una persona y encuentran dónde se pierde.

chameleonmode.app, con la descarga para Firefox y Chrome · Platanus Hack 26: Santiago ft. Buk · Track 🔗 Multiplayer

Cómo funciona

El tema de una página sale de una revisión, que se le pide a la API (just aws revision <url>). La extensión solo consulta las que existen:

flowchart LR
  P[Pedido de revisión] --> A[API]
  A --> C[Catalogador]
  C -->|un objetivo| G1[Guía] --> V1[Visitante]
  C -->|otro objetivo| G2[Guía] --> V2[Visitante]
  V1 --> D[Diseñador]
  V2 --> D
  D -->|tema.css| E[Extensión]
Loading
  1. El Catalogador lee la página y elige qué viene a hacer la gente en ella.
  2. Por cada objetivo, varios a la vez, la Guía encuentra y verifica el camino con el DOM; después el Visitante, un usuario sintético que solo ve capturas, intenta recorrerlo.
  3. El Diseñador escribe el tema con lo que aprendieron, y la extensión lo aplica para todos los que visitan esa página.

Cada paso queda en S3 y el estado de la revisión en DynamoDB, así que el backoffice muestra a los agentes trabajando mientras avanzan.

Pieza Qué es
extension/ Extensión de Firefox y Chrome que aplica el tema de cada página
backend/ API de revisiones: dispara la revisión de una página y entrega su tema
backoffice/ Visor de las revisiones y de los recorridos de los agentes
agents/app/conductor/ Conductor: corre una revisión completa, etapa por etapa
agents/app/cataloger/ Catalogador: cataloga los objetivos de un sitio, clasificados
agents/app/guide/ Guía: encuentra y verifica la ruta de un objetivo, con el DOM y capturas
agents/app/visitor/ Visitante: usuarios sintéticos que intentan un objetivo viendo solo capturas
agents/app/web_designer/ Diseñador: escribe el tema de la página
agents/app/summary/ Resumen de un sitio: la ruta de la Guía contra los intentos del Visitante
agents/app/runtime/ Entrada de los agentes en AWS AgentCore
agents/shared/ Lo que comparten los agentes: almacén, navegador, Claude, nodos, DOM y catálogo
infra/ Terraform y AgentCore: API, almacén, tabla, backoffice y runtime

Más detalle en docs/: arquitectura, objetivos y métricas y glosario.

Probarlo

No hace falta clonar nada:

  1. Instala la extensión desde chameleonmode.app. Todavía no está en las tiendas: la de Firefox (140 o superior) viene firmada por Mozilla y se instala desde el botón; la de Chrome (148 o superior) es un .zip que se carga en chrome://extensions con el modo desarrollador.
  2. Entra a una de las páginas de la demo, las que siembra just aws seed: las 8 de agents/tasks/demo.json (metro.cl, sii.cl, wom.cl, dt.gob.cl y otras). El tema es de esa página: las demás del mismo sitio quedan tal cual.
  3. El ícono de la extensión abre un interruptor que prende y apaga el tema; apagado, la página queda como la dejó el sitio.

El backoffice muestra cada revisión: los objetivos que encontró, el recorrido de cada usuario sintético y el tema que quedó.

Desarrollo local

Requisitos: just (brew install just), Node.js 22 o más reciente con npm, uv, Firefox (la extensión también corre en Chrome 148 o superior: npm run dev:chrome, ver extension/README.md) y, para los pasos 4, 5, 6, 8 y 9, Claude Code con la sesión iniciada. Probado en macOS. Desde un clon nuevo, en este orden:

just local setup                      # 1. once, after cloning: checks requirements, installs dependencies
just local up                         # 2. backend, backoffice (http://localhost:4848/backoffice/) and a separate Firefox with the extension, in the background
just local up sesion                  #    same, with a copy of your Firefox profile (made the first time)
just local down                       #    stops them (just local logs follows their logs)
just local test                       # 3. before pushing: every test that does not call Claude
just local catalog <url>              # 4. cataloger: goal catalog of a site (calls Claude)
just local guide <host>/<goal>        # 5. guide: reference route of a task in agents/tasks/ (calls Claude)
just local visit <url> "<task>"       # 6. visitor: synthetic users try a task on a site (calls Claude)
just local visit-tasks [wom|sii|dt]   #    visitor on the tasks in agents/tasks/ (calls Claude)
just local backoffice                 # 7. viewer of the visitor runs
just local revision <url>             # 8. the whole pipeline on one page: catalog, guide and visitor per goal, and tema.css (calls Claude)
just local site <url> [goals]         # 9. per site, without tema.css: catalog, guide and visitor per goal, and a summary (calls Claude)
just local summary <url>              #    rewrites that summary from the files on disk

Cada pull request a main corre las mismas pruebas en GitHub Actions (pruebas.yml): npm run check y pytest en cada proyecto de Python bajo agents/ que tenga tests/, sin llamar a Claude ni a AWS. El check Todas las pruebas tiene que pasar para mergear.

Los despliegues y las versiones de la extensión corren como GitHub Actions en un repo personal y privado, brayanmoreno/hackathon-grupo36, una copia de main de este (ver infra/README.md). Necesitan gh con la sesión iniciada:

just sync                             # copies main to the personal repo now and follows the deploy, if any
just publish v0.3.0                   # signs that version of the extension and publishes it as a release

Corre just local para ver esta lista. Funciona desde cualquier carpeta del repo; los comandos están en local/justfile.

En AWS

Los agentes corren en AgentCore, con Claude en Bedrock (export AWS_PROFILE=<perfil>). just aws revision <url> revisa una página completa, igual que just local revision <url>, y muestra su avance; just aws seed siembra las páginas de la demo. Todo se despliega solo al mergear a main: ver el runtime y la infraestructura. Corre just aws para ver todos los comandos.

Equipo

About

Project Repository for team-36 at Platanus Hack 26: Santiago ft. Buk

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages