examples/QUICK_FIX.md

🔧 Correção Rápida - Erro de Parsing

Problema: "Failed to parse file"

Solução Rápida:

1. Use o comando validate primeiro para ver o erro detalhado:

okto validate scripts/train.okt

2. Verifique o encoding do arquivo:

   • No VSCode: veja no canto inferior direito → deve mostrar "UTF-8"
   • Se não for UTF-8, clique e selecione "Save with Encoding" → "UTF-8"

3. Copie um arquivo de exemplo limpo:

# Copie o exemplo limpo
cp oktoscript/examples/test-t5-basic-clean.okt scripts/train.okt

4. Ou crie manualmente com este conteúdo mínimo:

# okto_version: "1.2"

PROJECT "test_t5_basic"

ENV {
  accelerator: "gpu"
  min_memory: "4GB"
  install_missing: true
}

DATASET {
  train: "dataset/train.jsonl"
  validation: "dataset/val.jsonl"
}

MODEL {
  base: "google/t5-small"
}

TRAIN {
  epochs: 3
  batch_size: 8
  learning_rate: 0.0001
}

EXPORT {
  format: ["okm"]
  path: "export/"
}

⚠️ Problemas Comuns:

1. Bloco de Notas do Windows adiciona BOM (Byte Order Mark)

   • Solução: Use VSCode ou Notepad++

2. Caracteres especiais em comentários ou strings

   • Solução: Use apenas ASCII ou UTF-8 válido

3. Aspas curvas " ou " ao invés de retas "

   • Solução: Use sempre aspas retas

4. Espaços invisíveis ou caracteres de controle

   • Solução: Re-digite o arquivo ou use um editor que mostre caracteres invisíveis

✅ Teste Rápido:

# 1. Validar
okto validate scripts/train.okt

# 2. Se validar, treinar
okto train scripts/train.okt