Descripción general
OHarness es tu asistente de IA para trabajar en tu ordenador local. Tú controlas el contexto, la memoria, los modelos y las herramientas.
El motor gestiona herramientas, contexto y permisos. Las solicitudes usan adaptadores y @earendil-works/pi-ai, ottoport y zod. Las dependencias cambian según la versión; no se afirma que el producto carezca de SDK.
Qué es
La clave es que el historial de la conversación se guarda en un formato neutral respecto al proveedor. La capa de adaptadores lo traduce al formato de red de cada proveedor en el momento en que sale una solicitud, y por eso cambiar de modelo a mitad de sesión no requiere ninguna migración: la siguiente solicitud simplemente usa otro renderizador.
Tres interfaces, un motor
| Superficie | Comando | Para |
|---|---|---|
| Terminal | oharness | Una TUI a pantalla completa |
| Headless | oharness-headless | JSONL en stdout, para scripts |
| Navegador | oharness-web | HTTP + SSE, y la aplicación de escritorio |
El motor nunca escribe en stdout ni toca la terminal, y eso es lo que permite que exista una segunda interfaz sin modificarlo. Ese límite lo garantizan las pruebas, no una convención.
Elige un camino
Los enlaces apuntan a los propios archivos .md y no al .html renderizado, porque este directorio se lee en dos lugares y solo uno de ellos lo renderiza. Un enlace .html funciona en el sitio y da un 404 a quien lea la misma página en el repositorio, que es donde la mayoría la encuentra primero; un enlace .md funciona allí, y cualquier generador que valga la pena lo reescribe para el sitio.
Empieza a usar OHarness
- Primeros pasos — instalación, claves, primera ejecución
- Proveedores y modelos — el catálogo, el descubrimiento, la autenticación
- Permisos — modos, reglas, el registro de auditoría
- Interfaces — terminal, headless, navegador, escritorio
Configúralo y ponlo en marcha
- Archivos de configuración — qué va en cada sitio y qué archivo prevalece
- Ajustes avanzados — cada clave de configuración y variable de entorno que la página de Ajustes no muestra
- Memoria y sincronización — notas locales, recuperación, extracción y conciliación con la nube
- Sincronización autoalojada — despliega el servidor incluido y apunta los clientes a él
Implementa un servicio de sincronización
- Protocolo de sincronización — autenticación, feeds de sesiones, CAS de memoria, errores y comprobaciones de compatibilidad
La sincronización de sesiones puede implementarse por separado. La sincronización de memoria es un protocolo opcional independiente en el mismo origen; no requiere Supabase ni R2 si otra implementación ofrece una semántica de identidad y almacenamiento equivalente.
Entiende y amplía el sistema
- Arquitectura — límites entre paquetes y flujo de datos
- Plugins de runtime — el host y lo que puede hacer un plugin
- Conectores en la nube — conectar una cuenta que custodia la plataforma
- Plugin de Composio — un conector incluido como ejemplo
Contribuye y publica versiones con seguridad
- Contribuir — flujo de desarrollo y pull requests
- Seguridad — versiones compatibles y notificación privada de vulnerabilidades
- Código de conducta — expectativas de la comunidad
- Novedades — comportamiento publicado y notas de actualización