Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update Model Kit Specification #44

Merged
merged 2 commits into from
Feb 27, 2024
Merged

Update Model Kit Specification #44

merged 2 commits into from
Feb 27, 2024

Conversation

gorkem
Copy link
Contributor

@gorkem gorkem commented Feb 26, 2024

Updates the model kit specification with the current state

@gorkem gorkem requested a review from bmicklea February 26, 2024 15:24
Copy link
Contributor

@bmicklea bmicklea left a comment

Choose a reason for hiding this comment

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

Much more complete and clear. I've left some suggestions for changes.

docs/src/docs/manifest/model-kit.excalidraw.svg Outdated Show resolved Hide resolved
pkg/artifact/spec.md Outdated Show resolved Hide resolved

**Model Manifest:** Each model artifact has an associated JSON structure which describes some basic information about the model such as date created, author, format as well as inference time configuration.The JSON structure also references a cryptographic hash of each layer used by the model artifact, This JSON is considered to be immutable, because changing it would change the computed modelID. Changing it means creating a new derived model package, instead of changing the existing model image.
**Artifacts:** The building blocks of a model kit. Artifacts can be models, datasets, or code, each stored and addressed individually. This modular approach facilitates direct access via tools. Artifact metadata is encapsulated within the kit configuration file, ensuring comprehensive documentation of each component.
Copy link
Contributor

Choose a reason for hiding this comment

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

Change "model kit" to "ModelKit". Also is the "kit configuration file" the manifest, the Kitfile, or both? I think we should be specific.


**Model Kit Manifest:** This JSON document provides essential information about the model, including creation date, authorship, and a cryptographic hash of each artifact and the Kitfile. The manifest is immutable to preserve the integrity of the ModelKitID, ensuring any modification results in the derivation of a new model kit rather than altering the existing one.
Copy link
Contributor

Choose a reason for hiding this comment

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

Replace "derivation" with "creation". You can say "...results in the creation of a new derived ModelKit..." if the fact that it's a derivative is important.

pkg/artifact/spec.md Show resolved Hide resolved
pkg/artifact/spec.md Outdated Show resolved Hide resolved
pkg/artifact/spec.md Outdated Show resolved Hide resolved
@gorkem gorkem merged commit 72e4e11 into main Feb 27, 2024
1 check passed
@gorkem gorkem deleted the spec-update branch February 27, 2024 16:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants