fn_registry/functions/infra/audit_ml_env.md

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, tested, tests, test_file_path, file_path, params, output

name	kind	lang	domain	version	purity	signature	description	tags	uses_functions	uses_types	returns	returns_optional	error_type	imports	tested	tests	test_file_path	file_path	params	output
audit_ml_env	function	go	infra	1.0.0	impure	func AuditMlEnv(registryRoot string) (MlEnvReport, error)	Audita el entorno ML del sistema: GPUs NVIDIA, toolkit CUDA, venv Python, paquetes clave (torch, diffusers, transformers, huggingface_hub), herramientas CLI (sd, llama-cli) y el vault de modelos. Retorna un MlEnvReport con OverallOK=true solo si hay al menos 1 GPU y los checks criticos estan en ok/warning.	ml cuda gpu nvidia audit doctor infra torch diffusers pendiente-usar	get_gpu_info_go_infra	gpu_info_go_infra		false	error_go_core	context fmt os os/exec path/filepath strings time	true	report no nil y tiene checks generated_at es positivo checks tiene al menos 4 entradas gpus puede ser vacio en CI	functions/infra/audit_ml_env_test.go	functions/infra/audit_ml_env.go	name desc registryRoot Ruta absoluta a la raiz del fn_registry. Se usa para localizar python/.venv/bin/python3 y probar paquetes instalados.	MlEnvReport con Gpus (puede estar vacio si no hay NVIDIA), Checks con estado por herramienta/paquete, OverallOK y GeneratedAt (unix timestamp).

Checks realizados

Check	Tipo	Critico
nvidia_smi	binary in PATH	no (ok si hay GPU)
nvcc	CUDA toolkit version	no
python_venv	exists + python3 --version	si
torch	import torch; __version__	si
diffusers	import diffusers; __version__	si
transformers	import transformers; __version__	si
huggingface_hub	import huggingface_hub; __version__	si
stable_diffusion_cpp_python	import stable_diffusion_cpp	no (opcional)
sd_cli	sd --version in PATH	no (opcional)
llama_cpp	llama-cli --version in PATH	no (opcional)
imagegen_vault	~/vaults/imagegen_models exists	no

Ejemplo

root := "$HOME/fn_registry"
report, err := AuditMlEnv(root)
if err != nil {
    log.Fatal(err)
}
for _, c := range report.Checks {
    fmt.Printf("%-40s %s  %s\n", c.Name, c.Status, c.Version)
}
fmt.Printf("OverallOK: %v\n", report.OverallOK)

Notas

• Cada check tiene timeout de 5 segundos para no bloquear en entornos sin GPU.
• stable_diffusion_cpp_python, sd_cli y llama_cpp son opcionales: si estan missing, OverallOK no se ve afectado.
• OverallOK requiere al menos 1 GPU NVIDIA detectada via GetGpuInfo().
• No escribe nada en disco. Read-only.
• Se expone como fn doctor ml via cmd/fn/doctor.go.