CLI Oficial

CLI Oficial

O projeto usa python -m rede_neural_do_zero como interface oficial.

Compatibilidade:

• python -m src continua funcionando para nao quebrar material antigo.
• python -m rede_neural_do_zero e o caminho recomendado daqui para frente.

Ajuda

python -m rede_neural_do_zero --help
python -m rede_neural_do_zero train --help

Comandos principais

train

Treina um modelo e salva:

• parametros
• checkpoint completo
• resumo JSON
• configuracao efetiva usada na execucao

python -m rede_neural_do_zero train --dataset iris --epochs 160 --save-dir results/iris
python -m rede_neural_do_zero train --config configs/train/iris.yaml

resume

Retoma um treino salvo a partir de checkpoint.

python -m rede_neural_do_zero resume --checkpoint results/iris/model-checkpoint.npz --dataset iris --epochs 40

evaluate

Executa avaliacao deterministica com gate minimo.

python -m rede_neural_do_zero evaluate --dataset diabetes --min-score 0.20
python -m rede_neural_do_zero evaluate --config configs/evaluate/diabetes.toml

benchmark

Executa comparacoes multi-seed com media, desvio, ranking e relatorio Markdown.

python -m rede_neural_do_zero benchmark --mode multiclasse --dataset wine --seeds 42,52,62
python -m rede_neural_do_zero benchmark --datasets iris,wine,diabetes --seeds 42,52,62
python -m rede_neural_do_zero benchmark --config configs/benchmark/suite.yaml

example

Executa fluxos prontos com datasets sinteticos ou reais.

python -m rede_neural_do_zero example --dataset xor
python -m rede_neural_do_zero example --config configs/example/wine.json

build-docs

python -m rede_neural_do_zero build-docs --strict

build-package

python -m rede_neural_do_zero build-package --check

verify

python -m rede_neural_do_zero verify
python -m rede_neural_do_zero verify --build-package

Arquivos de configuracao

Os subcomandos train, resume, evaluate, benchmark e example aceitam --config em:

• JSON
• TOML
• YAML

Exemplo:

common:
  seed: 42
  no_plots: true

train:
  dataset: iris
  epochs: 180
  save_dir: experiments/runs/iris-baseline