Browser AI (Título Provisional)

Estado del Proyecto

Título Provisional: Browser AI
Estado: En Desarrollo

Descripción

Para una descripción completa del proyecto, incluyendo propósito y público objetivo, consulta docs/general-description.md.

Stack Tecnológico

• Plataforma: Extensión de Chrome (Manifest V3)
• Lenguaje: TypeScript
• Estilos: Tailwind CSS
• Frameworks: Vue 3 + WXT
• Herramienta de Compilación: Vite
• Interfaz: Panel Lateral (sidePanel) + menú contextual
• IA: Enfoque híbrido (APIs nativas del navegador + servicios en la nube)

Características Principales

• ✅ Privacidad Total: Procesamiento local usando APIs nativas del navegador
• ✅ Sin Costos: No hay límites de API ni tarifas
• ✅ Funcionamiento Offline: Análisis sin conexión a internet
• ✅ Enfoque Híbrido: Opción de usar IA en la nube cuando sea necesario
• ✅ Interfaz Simple: Diseño intuitivo sin conocimientos técnicos requeridos

Funcionalidades

• Corrección de Texto: Detección y sugerencias de errores gramaticales

• Traducción: Traducción automática entre múltiples idiomas

• Extracción de Ideas Clave: Resumen automático de conceptos principales

• Reconocimiento de Entidades: Identificación de personas, lugares, organizaciones

Documentación

La documentación técnica completa se encuentra en la carpeta docs/:

Apoya el Proyecto

Si sintonizas con este proyecto y quieres apoyar su desarrollo, puedes hacer una donación:

🌍 Donaciones Recurrentes

• Liberapay

  Liberapay es una organización sin fines de lucro que facilita a los desarrolladores de software libre un soporte mensual para sostener su trabajo continuado:

• Github Sponsors

Donaciones por única vez

🌍 Donaciones Internacionales

🇦🇷 Donaciones Locales (Argentina)

• Alias: ecicala.nx
• CBU: 4530000800011535996333
• Titular: Ezequiel Cicala

Instalación y Uso

Requisitos

• Chrome 138 o superior: Requerido para las APIs de IA integradas

Requisitos de Hardware

• Sistema operativo: Windows 10/11, macOS 13+ (Ventura), Linux, o ChromeOS (desde Platform 16389.0.0) en dispositivos Chromebook Plus
• Dispositivo: Solo escritorio (no funciona en móviles)
• Red: Conexión sin límites de datos

Para usar las APIs de IA integradas, excepto traducción:

• GPU: Estrictamente más de 4 GB de VRAM o CPU: 16 GB de RAM o más y 4 núcleos de CPU o más
• Almacenamiento: Al menos 22 GB de espacio libre en el volumen que contiene tu perfil de Chrome

Instalación para Desarrollo

1. Clonar el repositorio:

   git clone <repository-url>
   cd browser-ai

2. Instalar dependencias:

   npm install

3. Construir la extensión:

   npm run build

4. Cargar en Chrome:

   • Abrir Chrome y ir a chrome://extensions/
   • Activar "Modo de desarrollador"
   • Hacer clic en "Cargar extensión sin empaquetar"
   • Seleccionar la carpeta dist/

Uso

1. Traducción desde selección de texto:

   • Seleccionar texto en cualquier página web
   • Hacer clic derecho y seleccionar "Traducir con Browser AI"
   • El panel lateral se abrirá automáticamente con la traducción

2. Traducción manual:

   • Hacer clic en el icono de Browser AI en la barra de herramientas
   • Escribir o pegar texto en el panel lateral
   • Seleccionar idioma destino y hacer clic en "Traducir"

3. Configuración:

   • Ir a chrome://extensions/
   • Buscar Browser AI y hacer clic en "Opciones"
   • Configurar idioma destino predeterminado y modo de privacidad

Scripts de Desarrollo

npm run dev          # Modo desarrollo con hot reload
npm run build        # Construir para producción
npm run test         # Ejecutar pruebas
npm run lint         # Linter
npm run type-check   # Verificación de tipos TypeScript

APIs Utilizadas

Browser AI utiliza las siguientes APIs integradas de Chrome:

• Translator API: Para traducción de texto
• Language Detector API: Para detección automática del idioma
• Summarizer API: Para resumen de texto

🤝 Contribución y Colaboración

¡Tu contribución es bienvenida! Este proyecto sigue un enfoque de especificación primero (Specification-First). Todos los cambios deben documentarse primero en los archivos .md correspondientes antes de proceder con la implementación en código.

📖 Guías de Contribución

• CONTRIBUTING.md: Guía completa para contribuir al proyecto
• Código de Conducta: Normas de comportamiento en la comunidad
• Plantilla de PR: Plantilla para Pull Requests

🔧 Flujo de Trabajo

1. Revisar documentación en docs/ antes de comenzar
2. Crear un issue usando las plantillas disponibles
3. Desarrollar siguiendo las reglas del proyecto
4. Crear un PR usando la plantilla proporcionada
5. Esperar revisión y aprobación del equipo

🧪 Verificaciones Automáticas

El proyecto incluye integración continua (CI) que verifica:

• ✅ Linting con ESLint
• ✅ Verificación de tipos TypeScript
• ✅ Ejecución de pruebas unitarias
• ✅ Build exitoso

📝 Reglas de Colaboración

• Código y Estructura: Inglés
• Documentación y Comentarios: Castellano
• Nomenclatura: Seguir convenciones establecidas en AGENTS.md
• Pruebas: Obligatorias para nueva funcionalidad
• Commits: Seguir Conventional Commits

Licencia

Este proyecto está licenciado bajo la MIT License - ver el archivo LICENSE para más detalles.