PUTER LOCAL SIN SUSCRIPCION

Abre http://puter.localhost:4100 en el navegador.
Para arrancar la instancia, ejecuta Start-Puter-Local.cmd.
Para detener una instancia iniciada con ese archivo, pulsa Ctrl+C.
Stop-Puter-Local.cmd tambien permite detener la instancia si esta en segundo plano.

El archivo config.json contiene la configuracion privada y los secretos de esta
instancia. Los usuarios, archivos y datos persistentes estan en volatile/standalone.
Conserva juntos config.json y esa carpeta para respaldar la instancia.
El acceso inicial del administrador se guarda en volatile/standalone/admin-login.txt.

Los controles de planes y creditos de Puter estan desactivados. La interfaz, el
SDK, las cuentas y el almacenamiento se sirven desde este PC. El puerto principal
y el almacenamiento de objetos escuchan en 127.0.0.1.

La IA esta desactivada inicialmente. Para conectar tu Ollama local, inicia Ollama
y cambia providers.ollama.enabled a true en config.json. Reinicia Puter. Los modelos
deben estar instalados en Ollama; los modelos con etiqueta cloud usan Internet.
Las claves de proveedores externos son opcionales y su consumo lo cobra cada
proveedor. Esta instancia no utiliza la suscripcion ni los creditos de Puter.com.

Esta es una instancia autonoma, no un paquete completamente desconectado de Internet.
Las aplicaciones externas del catalogo y algunos recursos visuales pueden requerir
conexion. Las aplicaciones que quieras usar sin Internet deben alojarse localmente.

El codigo de esta variante esta en la rama codex/standalone-local. Despues de cambiar
el backend, ejecuta npm run build:ts antes de volver a iniciar la instancia.

CLI PARA UNA IA LOCAL

Con Puter iniciado, abre PowerShell y ejecuta:

  D:\puter\Puter-AI.cmd setup
  D:\puter\Puter-AI.cmd tools
  D:\puter\Puter-AI.cmd call system_info '{}'

El primer comando crea una cuenta invitada separada para la IA y guarda su sesion
en la configuracion de tu usuario de Windows. Los siguientes usos reutilizan esa
cuenta. Sus archivos y datos KV se guardan en este Puter; el agente puede operar
sobre su propia cuenta. Para acceder a otra cuenta necesitas su token local.

Ejemplo para escribir y leer desde PowerShell:

  '{"path":"puter:/Documents/nota.txt","content":"Hola desde mi IA local"}' | D:\puter\Puter-AI.cmd call fs_write
  '{"path":"puter:/Documents/nota.txt"}' | D:\puter\Puter-AI.cmd call fs_read

Hay 17 herramientas: identidad, archivos, datos KV, publicar apps en Pages y
crear/anadir/editar/leer hojas XLSX con GridCraft. El comando tools devuelve sus
esquemas JSON en result.tools para entregarlos a un modelo con function calling.
Tu controlador ejecuta la llamada que propone el modelo y le devuelve el resultado.
La CLI no ejecuta ni descarga el modelo de IA.

Para un controlador persistente usa:

  D:\puter\Puter-AI.cmd serve

Cada linea de entrada es un objeto JSON, por ejemplo:

  {"id":1,"tool":"fs_list","arguments":{"path":"puter:/Documents"}}

Cada respuesta ocupa una linea y contiene id, ok y result (o error). El modo serve
atiende en orden y termina al cerrar stdin. Puedes usarlo desde Python, Node o
cualquier aplicacion local que pueda lanzar procesos y leer/escribir sus canales.

Las rutas empiezan por puter:/ y pertenecen a la cuenta conectada. La CLI no ofrece
una herramienta de shell de Windows. fs_write requiere overwrite: true para
sobrescribir; sheet_write y sheet_add guardan el XLSX editado. Para borrar se
requiere confirm: true; los directorios tambien necesitan recursive:
true. Son parametros de la llamada, no un dialogo de aprobacion humana.

Conserva el archivo de sesion que muestra setup: contiene un token privado, y una
cuenta invitada no tiene contrasena para recuperarse si lo pierdes. Si la sesion
caduca, importa un token vigente con setup --with-token. No compartas ese archivo.
PUTER_AGENT_CONFIG_DIR permite separar las sesiones de distintos agentes.

La referencia de comandos, limites y protocolo esta en src/cli/README.md.

APPS EN CLOUDFLARE PAGES

El SDK del escritorio y de Dev Center se sirve desde /sdk/puter.js en este PC.
Las apps publicadas incluyen una copia de ese SDK en su propio despliegue de
Pages, junto con un bootstrap que apunta a tu API local. Las credenciales de
Puter y Cloudflare se mantienen fuera de los archivos publicados.

cloudflarePages esta habilitado en config.json con la cuenta de Mauricio. La
autenticacion la proporciona la sesion de Wrangler guardada en este PC.
Dev Center usa Pages para crear y desplegar apps cuando esta opcion esta activa.
Las apps existentes cambian de hosting cuando vuelves a desplegarlas.

Desde la CLI de IA, crea index.html y los archivos de la app en una carpeta de
Puter y ejecuta:

  '{"path":"puter:/Apps/mi-app","name":"mi-app","title":"Mi app"}' | D:\puter\Puter-AI.cmd call app_deploy

Se permite un maximo de 200 entradas, 25 MiB por archivo y 32 MiB en total,
sin contar el SDK. Publica solamente el resultado compilado de tu app. Se
rechazan archivos de configuracion privados, claves y carpetas ocultas.
Cada app usa su propio proyecto de Pages y conserva una URL estable al actualizar.

localGateway esta activo. Puter abre cada app en un subdominio local independiente,
descarga sus archivos de Pages y sirve el SDK directamente desde este PC. Los
parametros de inicio, cookies y tokens no se reenvian a Cloudflare. Esta opcion
requiere un dominio .localhost y una zona separada del hosting estatico integrado.

El codigo web queda publico en Pages. Los archivos de usuario, las cuentas y KV
siguen en Puter local. La pasarela mantiene las peticiones del navegador en
loopback. Para usar la integracion, el visitante necesita Puter en su PC. Abrir
la URL publica de Pages directamente puede requerir permiso de red local.

Ejemplo funcionando:
  http://puter.localhost:4100/app/puter-pages-demo-local
Codigo del ejemplo: examples/local-pages/index.html
Al abrirlo escribe y lee la clave pages-demo en el KV local de esa app.

GRIDCRAFT

  http://puter.localhost:4100/app/gridcraft-local

Usa Archivo > Abrir > Examinar para seleccionar una hoja de Puter. Archivo >
Guardar / Guardar como > Descargar (.xlsx), o Ctrl+S, abre el selector de Puter
para elegir destino. Toda la interfaz de archivos pertenece al editor nativo.

Para que una IA local cree y edite hojas, instala el motor oficial una vez:

  node tools/setupGridcraft.mjs

El instalador verifica SHA-256. Las herramientas sheet_create, sheet_add,
sheet_write y sheet_read usan ese motor local y guardan en la cuenta de la CLI.
El ejemplo completo se puede ejecutar desde D:\puter:

  Get-Content examples/gridcraft/cli-demo.jsonl | D:\puter\Puter-AI.cmd serve

Crea Documents/IA-GridCraft.xlsx. Si ya existe, usa otro nombre para la creacion.
La cuenta del navegador puede ser distinta; ambos necesitan acceso al mismo
archivo. La app actualizada recibe los cambios de la CLI en vivo y conserva
la hoja y la seleccion. Si hay cambios locales, permite conservar el borrador
o cargar la version de Puter. events.enabled esta activo en esta instancia.
La referencia y los
comandos reproducibles estan en src/cli/README.md y examples/gridcraft/README.md.
