Instalación
SoberanIA se instala desde el espejo privado de Ch'aska — el paquete jamás toca PyPI. Requiere una máquina Linux o WSL2 con Python 3.13+. Una sola clave: el correo y la contraseña de esta misma cuenta, una vez.
Linux / WSL2
curl -fsSL https://espejo.soberania.chaska.ar/instalar.sh | sh
El instalador pide la credencial del espejo (este mismo correo y
contraseña, sin eco) y la deja persistida: instalar es
también ingresar. Baja el wheel y las dependencias
congeladas del canal estable, verifica los checksums
y la firma PGP de Ch'aska, e instala en una disposición versionada
bajo ~/.local/lib/soberania/.
Windows
irm https://espejo.soberania.chaska.ar/instalar.ps1 | iex
En PowerShell, sin entrar a WSL a mano y sin bajar ningún archivo:
el espejo sirve instalar.ps1 y el envoltorio
soberania.ps1 por HTTPS. El script coordina la mitad
WSL, instala el túnel a nivel Windows (una elevación UAC) y deja
soberania invocable desde ambos lados.
El túnel a las DGX se arma solo
No hace falta bajar ni importar ningún archivo de configuración:
con la misma credencial, el instalador emite el
.conf de esta máquina y lo aplica — un túnel
por máquina, con su propia dirección en la red de las DGX. La
pregunta «¿regenerar?» aparece sólo al reinstalar en una máquina
que ya tenía el suyo.
La descarga manual desde Configuración → Red de las
DGX queda como respaldo: sirve para importar el
túnel en un cliente WireGuard que el instalador no maneje, o para
recuperar una máquina cuyo .conf se perdió. El camino
principal es el oneliner.
Después de instalar
soberania # abre la TUI soberania version # qué versión corre y de qué canal vino soberania actualizar # trae la última del canal (estable por defecto) soberania cuenta # la sesión contra el espejo soberania desconectar # revoca el token y borra la credencial local
La herramienta se actualiza sola contra el espejo: chequea una vez
por día con caché y avisa en el pie de la TUI cuando hay versión
nueva. Hay tres canales: estable (el de siempre),
beta (el banco de pruebas — funcionalidad nueva que
puede no llegar a estable, o llegar muy reversionada) y
nocturno (head de desarrollo, construido
cada noche). Se eligen con
soberania actualizar --canal beta, y el canal elegido
queda anotado en el manifiesto: los /actualizar
siguientes se quedan en ese canal, no vuelven solos a estable.
Documentación
Referencia de alto nivel. El detalle completo — especificaciones, decisiones de implementación y los informes de investigación — vive en el repositorio privado Ch-aska/soberan-ia.
Qué es SoberanIA
Un harness agéntico propio, con agentes base RAC (Robot Alucinador de Ch'aska), capaz de hablar indistintamente con Claude (API de Anthropic) y con un modelo de pesos abiertos corriendo sobre hardware propio, detrás de un único contrato. El objetivo: que el equipo de ciberseguridad de Ch'aska no dependa de la disponibilidad, el precio ni las políticas de un único proveedor cerrado.
Qué puede hacer RAC hoy
Conversar con dos proveedores por un solo contrato; leer, escribir
y editar código con pre-imagen; operar git de punta a punta (con
firma y verificación PGP) y GitHub con gh; correr las
pruebas; buscar en la web y leer páginas con confinamiento;
ejecutar comandos de shell con aprobación; operar infraestructura
remota por SSH/SCP con aprobación por host; recordar entre
corridas, deshacer ediciones y trabajar en una arena descartable;
cargar skills del estándar abierto y hablar con servidores MCP;
trabajar en equipo con flujos agénticos (capataz/obreros,
aprendiz/sabio) y organizar horizonte largo con el Sistema de
Tareas.
Comandos de la TUI
/ayuda la tabla completa de comandos /version versión, origen y último chequeo /cuenta la sesión contra el espejo /actualizar trae la última versión del canal /modelo cambia de modelo sin perder la conversación /objetivo fija un objetivo y cicla hasta cumplirlo
Arquitectura, en un párrafo
Un grafo de agentes RAC: fan-out de trabajo en equipo sobre el tier barato y una única síntesis de juicio sobre el tier caro. La distribución es soberana: espejo privado con artefactos firmados (la clave madre de Ch'aska queda offline; el espejo firma con una subclave derivada), credenciales atadas a usuario+máquina, y autoactualización verificada de punta a punta. El porqué completo está en los Informes I y II del repositorio.
Configuración
Lo que puede cambiar sobre su propia cuenta. El equipo y el rol los fija un administrador; el servidor es la autoridad sobre ambos.
Mi cuenta
Red de las DGX (WireGuard)
Aprovisionamiento de DGX no configurado en el espejo.
| Máquina | Dirección | Estado | Emitida | Acciones |
|---|
Guárdela ahora: el espejo no conserva la clave
privada; si la pierde, regenere. El archivo ya se descargó con el
nombre ; impórtelo en
su cliente WireGuard.
Nombre para mostrar
Cambiar contraseña
Sesión
Rotar el token invalida el actual y emite uno nuevo en el mismo pedido — la sesión de este navegador sigue, con credencial fresca.
Estado
Salud de los servicios de SoberanIA, medida en vivo desde este navegador. Se refresca sola cada 30 segundos.
Usuarios
Gestión de las cuentas del espejo — sólo administradores. La baja y el reinicio de contraseña revocan las sesiones del usuario; la rotación revoca sesiones sin tocar la contraseña. El alta puede dejar a la persona, en el mismo trámite, con su clave del gateway de las DGX y su acceso WireGuard; la baja revoca ambos.
Aprovisionamiento de DGX no configurado en el espejo.
| Usuario | Nombre | Equipo | Rol | Tipo | Red | Canal | Acceso DGX | Acciones |
|---|
Uso
El consumo del período por proveedor de modelos, contra su tope si hay uno. Los administradores ven además el agregado por usuario, equipo y proveedor.
Mi consumo contra mi tope
Agregado del equipo (administración)
| Dimensión | Quién | Pedidos | Tokens (entrada / salida) | Costo estimado |
|---|
Todo esto es telemetría de cliente: cada harness reporta lo que dice haber consumido, valuado con los precios de referencia del catálogo — orden de magnitud para gobierno interno, no contabilidad. Un modelo sin precio de referencia registra sus tokens pero no aporta gasto contra el tope hasta que se lo agregue al catálogo. Para facturar, la fuente es la consola del proveedor.
Claves de proveedor
El padrón de claves que el espejo reparte como arriendos (30 días, cifrados
por máquina) — sólo administradores. Revocar corta la emisión: el arriendo
vigente muere solo al vencer. Para las claves de las DGX (proveedor
chaska) revocar además bloquea la key en el gateway;
para el resto de los proveedores la key sigue activa allá hasta que alguien
la rote.
Aprovisionamiento de DGX no configurado en el espejo.
Clave DGX para una persona
El espejo pide la key al gateway de las DGX (alias = correo, equipo
ch-aska), la sella y la asigna a la persona en el acto.
El valor no pasa por acá: se reparte como arriendo, igual
que las demás. Una persona, una key: para rotar, revoque y acuñe de nuevo.
Clave DGX sin asociar
El espejo pide una key al gateway de las DGX con la etiqueta que
elija (será el key_alias, y debe ser única), la sella y
la guarda en el padrón sin destinatarios. Asígnela
después con la acción «✎ Alcance» de su fila (o
espejo asignar-clave). El valor no pasa por acá.
Nueva clave — el secreto no viaja por acá
El alta de un secreto por HTTP no existe a propósito
(D-V7.23): el valor de la API key entra sólo por la CLI local del
servidor, sobre SSH, con getpass — exposición cero.
Complete proveedor y etiqueta y corra este comando en el servidor:
Después asígnela desde esta misma tabla (o con
espejo asignar-clave).
| Clave | Proveedor | Etiqueta | Estado | Gateway | Alcance | Creada | Acciones |
|---|
Topes de gasto
Límites de gasto estimado en US$ por mes calendario (UTC), en cuatro capas: por defecto, por equipo, por usuario y por clave — el más específico gana. Alcanzado un tope, la pausa no se levanta sola al cambiar de mes: reactivarla desde acá es el único camino.
Resueltos por usuario — «¿cuánto tiene esta persona?»
| Usuario | Proveedor | Tope | Origen | Consumido |
|---|
Declarados
Pausas vigentes
| Usuario | Proveedor | Motivo | Desde | Acciones |
|---|