fak — instalación y primeros pasos

Esta es una página de entrada localizada (entry point), no una traducción completa de la documentación. La documentación canónica está en inglés — esta página te lleva de un checkout limpio a un kernel en marcha, con los dos comandos de instalación y el mapa de tiers, y luego te deriva a la documentación en inglés. Aviso: esta página está generada automáticamente y está pendiente de revisión nativa — se agradecen correcciones por issue/PR.

Todos los idiomas en el hub i18n. El punto de partida en español es el README.

Esta es la puerta de entrada de instalar-y-ejecutar. El pitch denso está en el README. Aquí vas de un checkout limpio a un kernel funcionando y a servir un modelo por detrás, con comandos que se pueden copiar y pegar.

0. Requisitos

1. El mapa de tiers

fak es un único binario Go: un artefacto estático sin dependencias externas. Ese mismo binario es toda la superficie — el gateway, el KV cache y el motor de enrutado, los ahorradores de tokens y, en la misma costura, el capability floor, la cuarentena de resultados y el registro de auditoría. Hay cuatro cosas que puedes hacer con él, en orden creciente de coste de setup, y entre una y otra no se instala nada nuevo:

Tier Qué obtienes Setup
0 — Probar el kernel Ejecutar/medir la frontera de adjudicación offline go build
1 — Poner delante un modelo real El kernel delante de un modelo que sirves en otro sitio (Ollama / vLLM / llama.cpp / un proveedor cloud) + un servidor compatible con OpenAI
1b — Modelo local en un comando Un modelo GGUF local in-kernel con tu agente existente — sin key, sin red, sin segundo terminal fak guard --gguf qwen2.5:7b -- claude
2 — El modelo fusionado in-kernel La forward pass pura-Go que el kernel posee + (pesos reales) export en Python

Si solo quieres servir un modelo útil con fak por delante, quieres el Tier 1. El modelo in-kernel del Tier 2 es una forward pass de referencia probada bit-a-bit contra HuggingFace, no un motor de serving con calidad de chat.

2. Instalar el binario

Con Go. El module path github.com/anthony-chaudhary/fak es la raíz del repositorio, así que se instala directamente:

go install github.com/anthony-chaudhary/fak/cmd/fak@latest   # -> $(go env GOBIN) / $GOPATH/bin

Desde el clon (contribuidor):

git clone https://github.com/anthony-chaudhary/fak.git
cd fak
go build -o fak ./cmd/fak
./fak help

Nota Windows. Compila con go build -o fak.exe ./cmd/fak: go build -o fak (sin extensión) deja un fichero fak literal que cmd.exe / PowerShell no pueden lanzar por nombre. Luego invócalo como .\fak.exe donde esta guía escribe ./fak.

No reescribes tu agente: apuntas una base URL hacia fak, o envuelves un agente existente en un solo comando:

fak guard -- claude    # envuelve tu agente existente en un solo comando

3. La prueba de 60 segundos (sin key, sin modelo, sin GPU)

go build -o fak ./cmd/fak
./fak preflight --policy examples/customer-support-readonly-policy.json --tool refund_payment --args "{}"   # -> DENY (POLICY_BLOCK)
./fak preflight --policy examples/customer-support-readonly-policy.json --tool search_kb     --args "{}"   # -> ALLOW
./fak agent --offline                                                                                       # inyección detenida, tarea igualmente completada

El capability floor es default-deny y se comprueba dentro del kernel, en el mismo call path (fail-closed): una acción que no está en la allow-list no puede ejecutarse, por más que se convenza al modelo. En las pruebas en vivo, la prompt injection alcanzó la baseline sin proteger 5/5; fak la aisló 5/5.

Por qué importa para España, la UE y América Latina

Hacia dónde seguir

Licencia: Apache-2.0.