ForgeLM/docs/app/backend-commands.md

Comandos backend do app desktop

O backend Tauri exposto ao frontend vive principalmente em tauri-app/src-tauri/src/lib.rs.

Esta pagina documenta os comandos que o frontend usa para runtime, modelos e diagnostico.

Runtime manager

bootstrap_runtime_command

Carrega a configuracao persistida, reconstrui o snapshot do runtime e pode iniciar o runtime local automaticamente quando a politica e on_app_launch e o modo e local.

get_runtime_snapshot_command

Retorna o RuntimeSnapshot atual com:

• status
• ready
• process_running
• resolved_url
• binary_path
• last_error
• config

save_runtime_config_command_handler

Persiste RuntimeConfig e atualiza o estado backend usado pelo runtime manager.

Importante:

• se o processo local estiver rodando e a mudanca exigir restart, o backend pode recusar a alteracao com erro restart_required

start_runtime_command

Inicia o runtime local usando a configuracao atualmente salva no backend Tauri.

stop_runtime_command

Para o runtime local e atualiza o snapshot.

GPU e modelos

query_gpu

Usa nvidia-smi para detectar GPU NVIDIA e sugerir recommended_layers.

scan_models(dir)

Escaneia um diretorio em busca de arquivos .gguf.

pick_models_dir

Abre seletor nativo de pasta e devolve o diretorio escolhido junto com os modelos encontrados.

pick_model_files

Abre seletor nativo de arquivos para escolher um ou mais .gguf.

import_model(src_path, dest_dir)

Copia um arquivo .gguf para um diretorio de modelos.

Configuracao e paths

find_server_binary

Resolve o caminho do binario localllm para diagnostico e start local.

get_app_data_dir

Retorna o diretorio de dados do app.

O backend desktop agora expoe apenas a superficie unificada do runtime manager para configuracao e ciclo de vida.

Tipos principais

RuntimeConfig

Campos relevantes:

• connection_mode
• start_policy
• server_url
• api_key
• model_path
• models_dir
• addr
• gpu_layers
• ctx_size
• extra_model_paths

RuntimeSnapshot

Representa o estado serializado usado pelo frontend para desenhar o runtime card, drawer e logica de start/stop.

Observacoes importantes

• o backend Tauri e a source of truth da configuracao persistida do runtime do app
• o frontend usa useRuntimeManager() para consumir essa superficie de comandos
• readiness do runtime local depende de GET /health, nao apenas de socket aberto