Skip to content

feat!: development CLI to enable module-wise development #142

Merged
MauritsBleeker merged 21 commits into
mainfrom
feat-development-cli-tool
Apr 17, 2026
Merged

feat!: development CLI to enable module-wise development #142
MauritsBleeker merged 21 commits into
mainfrom
feat-development-cli-tool

Conversation

@MauritsBleeker
Copy link
Copy Markdown
Collaborator

@MauritsBleeker MauritsBleeker commented Apr 2, 2026

This pull request introduces a "development" workflow for the Noether framework, enabling building individual modules in isolation, with extensive logging. It provides an example configuration and integrates the development CLI into the documentation and CLI entry points. Additionally, it improves error handling for dataset normalizers and makes minor documentation and configuration updates.

@MauritsBleeker MauritsBleeker marked this pull request as draft April 2, 2026 14:03
Copy link
Copy Markdown
Collaborator

@HennerM HennerM left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am not sure who this is for? What's the advantage over running normal training?

Do we want to have the development in the repo? I suppose that's the one that someone would modify to do the debugging, in which case we don't want changes to it end up getting committed.

@MauritsBleeker MauritsBleeker marked this pull request as ready for review April 9, 2026 16:06
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 10, 2026

Coverage

Tests Skipped Failures Errors Time
1259 24 💤 0 ❌ 0 🔥 29.169s ⏱️

Copy link
Copy Markdown
Member

@Ndles Ndles left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good, I hope it will come in handy for devs and contributors. Left a few minor comments, the only one that I would prioritize is naming of the CLI command noether-development vs noether-dev.

return torch.randn((self.dataset_config.sample_size, self.dataset_config.z_dim))

Now, if we create a file `development_config.yaml` with the following content, we can test the dataset by running the `noether-development` CLI.
You can configure the batch size to be any value, but for testing purposes we set it to `8` (this is not the same batch size as the effective batch size used in the trainer).
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
You can configure the batch size to be any value, but for testing purposes we set it to `8` (this is not the same batch size as the effective batch size used in the trainer).
You can configure the batch size to be any value, but for testing purposes we set it to `8` (this is not the same batch size as the `effective_batch_size` used in the trainer).

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am not sure if this para is required, it should be clear that a reader can alter values as they wish

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

is there a specific reason you use print() and not a logger?

Comment thread pyproject.toml
noether-data = "noether.io.cli.cli:app"
noether-dataset-stats = "noether.data.tools.calculate_statistics:main"
noether-init = "noether.scaffold.cli:app"
noether-development = "noether.training.cli.development:main"
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

would it make sense to shorten the command to noether-dev?

@MauritsBleeker MauritsBleeker merged commit b9c57a0 into main Apr 17, 2026
8 of 9 checks passed
@MauritsBleeker MauritsBleeker deleted the feat-development-cli-tool branch April 17, 2026 09:38
@github-actions github-actions Bot locked and limited conversation to collaborators Apr 17, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants