Hugging Face's logo

OktoSeek
/
oktoscript

English
ai
training
dsl
oktoscript
oktoseek
okto
automation
ai-pipelines
ai-governance
Model card Files
xet
Community
oktoscript
File size: 2,526 Bytes 
5df2c77
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
 
# Troubleshooting - Problemas Comuns

## Erro: "Failed to parse file"

### Possíveis Causas:

1. **Encoding do arquivo**
   - O arquivo deve estar em **UTF-8 sem BOM**
   - Evite salvar no Bloco de Notas do Windows (pode adicionar BOM)
   - Use VSCode, Notepad++, ou outro editor que suporte UTF-8

2. **Caracteres invisíveis**
   - Copiar/colar pode adicionar caracteres invisíveis
   - Re-digite o arquivo ou use um editor que mostre caracteres invisíveis

3. **Problemas com comentários**
   - Comentários devem começar com `#` no início da linha
   - Evite caracteres especiais em comentários

4. **Aspas incorretas**
   - Use aspas retas `"` não aspas curvas `"` ou `"`
   - Verifique se todas as aspas estão fechadas

### Soluções:

#### 1. Validar o arquivo primeiro:
```bash

okto validate scripts/train.okt

```

Isso mostrará erros detalhados.

#### 2. Verificar encoding no VSCode:
- Abra o arquivo no VSCode
- Veja no canto inferior direito: deve mostrar "UTF-8"
- Se mostrar outro encoding, clique e selecione "Save with Encoding" → "UTF-8"

#### 3. Criar arquivo limpo:
```bash

# Copie o conteúdo do exemplo

cp oktoscript/examples/test-t5-basic.okt scripts/train.okt



# Ou crie manualmente

```

#### 4. Verificar sintaxe básica:
- Todas as strings devem estar entre aspas: `"valor"`
- Arrays devem usar colchetes: `["okm", "safetensors"]`
- Blocos devem ter chaves: `{ ... }`
- Não use vírgulas no final de arrays ou objetos

### Exemplo de arquivo correto:

```okt

# okto_version: "1.2"



PROJECT "test_t5_basic"

DESCRIPTION "Teste basico"



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/"

}

```

### Checklist:

- [ ] Arquivo está em UTF-8
- [ ] Todas as aspas estão fechadas
- [ ] Não há caracteres especiais invisíveis
- [ ] Sintaxe está correta (chaves, colchetes, etc.)
- [ ] `okto validate` passa sem erros

### Se ainda não funcionar:

1. Execute com `--debug` (se disponível):
```bash

okto validate scripts/train.okt --debug

```

2. Verifique o conteúdo do arquivo:
```bash

okto show scripts/train.okt

```

3. Compare com um exemplo que funciona:
```bash

okto validate oktoscript/examples/test-t5-basic.okt

```