Radoss Universal Avatar

La capa de configuración de escritorio sin código para un Avatar personal y propiedad del usuario.

NAAS es la autoridad del Avatar. Hermes es el agente visible de configuración y orquestación. SQLite + FTS5 es el libro de memoria canónico local. ReMe es una proyección legible opcional; Ollama queda deliberadamente excluido del producto público.

Para usuarios no técnicos

Use el instalador de escritorio firmado cuando se publique:

1. Instale y abra Radoss Universal Avatar.

2. Ponga nombre a su Avatar.

3. Elija un modo de privacidad.

4. Haga clic en Configurar mi Avatar.

5. Apruebe la conexión de la cuenta en el navegador. No copie un código ni un token.

6. Vuelva a abrir o actualice el host de IA compatible cuando el asistente confirme el adaptador local.

El asistente de escritorio crea copias de seguridad locales cifradas antes de las mutaciones y expone controles de reintento, reversión, privacidad, desconexión, estado y seguridad.

El producto tiene tres rutas de conexión deliberadamente diferentes:

• Usuarios sin código: usan el asistente de escritorio y OAuth del navegador; nunca copian un código, token o archivo de configuración.

• Desarrolladores: usan la CLI universal y los adaptadores MCP stdio locales cuando quieren control mediante scripts o repositorios.

• Usuarios de IA alojada: usan la puerta de enlace MCP HTTPS de marca y luego completan la conexión final de la cuenta de ChatGPT o Claude en la propia interfaz de ese host. Radoss nunca afirma que una cuenta de host esté conectada solo a partir de un archivo local.

Related MCP server: DODO MCP

Ruta de desarrollo con CLI

El paquete está preparado para su publicación pública en npm, pero aún no se ha publicado. Después de autenticar la cuenta de npm que posee el nombre del paquete, publique el tarball verificado con:

cd /path/to/radoss-universal-avatar
npm login
npm publish --access public

La CLI universal se mantiene por separado del repositorio fuente de NAAS. Su repositorio fuente público es innosaint-uche/radoss-universal-avatar.

Para el desarrollo local desde un checkout:

cd /path/to/radoss-universal-avatar
node bin/radoss.mjs setup
node bin/radoss.mjs setup status
node bin/radoss.mjs doctor
# Validate the deployed HTTPS MCP gateway without exposing a token
node bin/radoss.mjs mcp conformance https://mcp.naavos.radoss.agency/mcp --bearer-env RADOSS_GATEWAY_TOKEN --status-tool avatar_get

La CLI gestiona automáticamente los destinos locales compatibles:

• Codex: ~/.codex/config.toml

• Antigravity: ~/.gemini/config/mcp_config.json

• Hermes: ~/.hermes/profiles/avatar/config.yaml, perfil avatar aislado

Cada uno recibe el servidor MCP local radoss_avatar. Hermes sigue siendo el orquestador visible; el perfil predeterminado de Hermes no se reemplaza silenciosamente.

Límite de conexión

Los agentes locales usan MCP stdio protegido. La puerta de enlace HTTPS Streamable HTTP desplegada está disponible en https://mcp.naavos.radoss.agency/mcp con OAuth, aplicación de propiedad de inquilino respaldada por D1 y comprobaciones del ciclo de vida de MCP. La aceptación de inquilinos con dos usuarios vivos independientes sigue siendo una puerta de liberación pública separada. El origen canónico de Worker sigue siendo un detalle de implementación detrás de la ruta de marca Hostinger/Coolify. Las conexiones de cuenta de ChatGPT y Claude siguen siendo gestionadas por el host; un archivo de configuración local no puede probar una conexión en línea de ChatGPT o Claude.

El límite remoto y la evidencia de liberación requeridos para los clientes alojados se definen en docs/REMOTE_MCP_GATEWAY_CONTRACT.md. El sidecar local nunca debe exponerse directamente como conector público.

El flujo verificado de Hugging Face local completa OAuth del navegador, verifica la cuenta del proveedor, almacena las credenciales mediante el asistente de llavero de macOS y verifica por separado la caché propiedad de OAuth de Hermes. Nunca imprime ni almacena valores de token en el estado de configuración o en la configuración del agente.

Verificación

npm test
npm audit
npm pack --dry-run

Consulte docs/NO_CODE_SETUP.md para el contrato de evidencia y las puertas de liberación, y desktop-setup/README.md para el límite de empaquetado de Tauri.

Consulte docs/RELEASE_STATUS.md para los límites actuales de desarrollo, validación local y liberación al cliente.

QA universal

Las pruebas E2E reutilizables de navegador y superficie en vivo pertenecen al arnés central externo ~/.radoss-qa. Cada proyecto contribuye solo con un pequeño adaptador que describe su URL y contrato reales; no agrega Playwright, binarios de navegador ni Rust al proyecto. Rust se usa solo en un adaptador central de Tauri o de artefacto cuando se necesita evidencia de proceso, IPC, sistema de archivos o firma. Consulte el README del arnés local después de instalar el entorno de desarrollo universal.