Guías
- Inicio rápido
- Autenticación y claves
- Protección de claves
- Modelos, alias y alternativas
- Elección automática de modelo (silicon/auto)
- Chat completions
- Streaming
- Salidas estructuradas y herramientas
- Logprobs
- Visión
- Responses, Claude y Ollama
- Embeddings, rerank, audio e imágenes
- Archivos y lotes
- Documentos y búsqueda
- Adaptadores LoRA
- Etiquetas de proyecto y costes
- Caché de prefijos
- Cabeceras, límites de uso y topes de gasto
- Errores
- Privacidad y conservación de datos
- Recibos verificables
- Residencia de datos
- Precios
- Facturación
- Pago por solicitud (x402)
- Oráculo en cadena
- Crédito para agentes (líneas de cómputo respaldadas)
- Estado del servicio
- SDKs
- SDK de Swift
- Integraciones
- Ejecutar un nodo
- Agente para Linux
- API de cómputo
- Arquitectura
- Registro de cambios
- Glosario
Referencia de la API
Guía para operadores
Agente para Linux
El agente de nodo permite a un operador aprobado ofrecer un equipo con GPU o un servidor Linux para trabajo distinto de la inferencia de IA: renderizado, trabajos de entrenamiento, minería y, más adelante, servidores. Ejecuta cada trabajo como un contenedor en tu máquina e informa al plano de control.
Desactivado: no acepta trabajo
El agente está construido, pero la red aún no acepta agentes de Linux y no les envía trabajos. Un agente que se inicie hoy no registra nada ni ejecuta nada: anota en su registro que los agentes de Linux están desactivados y vuelve a preguntar cada diez minutos. Los pagos también están desactivados. Esta página describe cómo funcionará cuando se active.
Qué hace
- Abre una conexión saliente al plano de control por HTTPS con tu credencial de operador (
snop_...), la misma que usa un nodo del motor. No abre ningún puerto. - Anuncia la máquina: CPU, memoria, GPU con modelo y VRAM (mediante
nvidia-smiorocm-smi), disco libre, región y las cargas de trabajo y precios que elegiste. - Consulta si hay trabajos, ejecuta cada uno en un contenedor con Podman o Docker, envía sus registros, informa del uso cada minuto y detiene un trabajo cuando la red lo pide, cuando termina o cuando se agota su límite de tiempo.
Cómo se aíslan los trabajos
Cada trabajo se ejecuta con estos ajustes, que fija el agente y no el cliente:
- sin modo privilegiado, sin los espacios de nombres de red, procesos, IPC o usuarios del host, sin puertos publicados y sin rutas del host salvo el directorio de trabajo propio del trabajo
- todas las capacidades retiradas, sin nuevos privilegios, un usuario sin privilegios y un sistema de archivos raíz de solo lectura
- tus límites de CPU, memoria, procesos y memoria compartida, y un límite de tiempo estricto
- GPU solo cuando las permites
- solo imágenes fijadas por digest; las variables de entorno pasan por un archivo privado, nunca por la línea de comandos
Red según la carga de trabajo
Los trabajos de renderizado y entrenamiento no tienen red salvo que permitas el acceso saliente. La minería solo tiene acceso saliente, en una red propia. Los servidores deben recibir tráfico entrante solo a través del relay de Silicon Network; esa ruta aún no está construida, así que la red todavía no ofrece servidores en máquinas de operadores.
Tú ejecutas el trabajo, así que puedes ver su comando y sus variables de entorno. El uso de disco en el directorio de trabajo no tiene límite: pon el directorio de estado del agente en un volumen que los trabajos puedan llenar.
Precios e ingresos
Fijas tu propio precio por carga de trabajo: USD por hora de GPU para entrenamiento y renderizado, por hora para minería y servidores. La red muestra un precio solo como la oferta de una máquina en línea, nunca como un precio de mercado. El plano de control mide por sí mismo el tiempo de cada trabajo y cobra el menor entre su propia medida y la de tu agente. Mientras los pagos estén desactivados, el trabajo hecho solo aparecería como ingresos pendientes.
Instalación
Necesitas Linux (x86_64 o arm64), Python 3.11 o posterior y Podman 4 o Docker 24 o posterior; para GPU NVIDIA, el NVIDIA Container Toolkit, y para GPU AMD, ROCm. Primero hazte operador en la página Nodes del panel. Los pasos completos, la configuración de ejemplo y la unidad de systemd están en node-agent/README.md en el repositorio.
# as root, on the Linux machine
git clone https://github.com/ekempinski/siliconnetwork /opt/silicon-node-agent
python3 -m venv /opt/silicon-node-agent/.venv
/opt/silicon-node-agent/.venv/bin/pip install --require-hashes \
-r /opt/silicon-node-agent/node-agent/requirements.txt
# the credential, readable by root only
install -d -m 700 /etc/silicon-node-agent
sh -c 'umask 077; printf "%s\n" "snop_..." > /etc/silicon-node-agent/credential'
# the config: accepts nothing until you list workloads and prices
cp /opt/silicon-node-agent/node-agent/agent.example.toml /etc/silicon-node-agent/agent.toml
# check the config and the hardware (sends nothing)
cd /opt/silicon-node-agent/node-agent
/opt/silicon-node-agent/.venv/bin/python -m silicon_node_agent check
/opt/silicon-node-agent/.venv/bin/python -m silicon_node_agent detectTu configuración no acepta nada hasta que indiques cargas de trabajo y fijes un precio para cada una. check y detect no envían nada.
Para servir inferencia de IA en un Mac, consulta Ejecutar un nodo.