From 7f97ae898bb3f2ad56e0ddf046e263c11ff70d4c Mon Sep 17 00:00:00 2001 From: Angel Misevski Date: Fri, 23 Feb 2024 16:58:13 -0500 Subject: [PATCH] Remove duplicate copy of kit-file.md from pkg/cmd/build/ --- pkg/artifact/kit-file.md | 12 ++-- pkg/cmd/build/kit-file.md | 141 -------------------------------------- 2 files changed, 6 insertions(+), 147 deletions(-) delete mode 100644 pkg/cmd/build/kit-file.md diff --git a/pkg/artifact/kit-file.md b/pkg/artifact/kit-file.md index 0c4d57f5..5fc03f1a 100644 --- a/pkg/artifact/kit-file.md +++ b/pkg/artifact/kit-file.md @@ -1,4 +1,4 @@ -# KitOps AI/ML Packaging Manifest Format Reference +# Kitfile AI/ML Packaging Manifest Format Reference The Kitfile manifest for AI/ML is a YAML file designed to encapsulate all the necessary information about the package, including code, datasets, model, and their metadata. This reference documentation outlines the structure and specifications of the manifest format. @@ -59,13 +59,13 @@ This section provides general information about the AI/ML project. #### `model` - **Description**: Details of the trained models included in the package. -- **Type**: Object Array - - `name`: Name of the model +- **Type**: Object + - `name`: Name of the model - `path`: Location of the model file or directory relative to the context - `framework`: AI/ML framework - `version`: Version of the model - `description`: Overview of the model - - `license`: SPDX license identifier for the dataset. + - `license`: SPDX license identifier for the dataset. - `training`: - `dataset`: Name of the dataset - `parameters`: name value pairs @@ -115,7 +115,7 @@ models: ``` -## Future Considerations +## Future Considerations This section is for collecting future ideas. @@ -138,4 +138,4 @@ This section is for collecting future ideas. - name: pandas version: 1.1.3 license: BSD-3-Clause -``` \ No newline at end of file +``` diff --git a/pkg/cmd/build/kit-file.md b/pkg/cmd/build/kit-file.md deleted file mode 100644 index ae84fe37..00000000 --- a/pkg/cmd/build/kit-file.md +++ /dev/null @@ -1,141 +0,0 @@ -# Kitfile AI/ML Packaging Manifest Format Reference - -The Kitfile manifest for AI/ML is a YAML file designed to encapsulate all the necessary information about the package, including code, datasets, model, and their metadata. This reference documentation outlines the structure and specifications of the manifest format. - -## Overview - -The manifest is structured into several key sections: `version`, `package`,`code`, `datasets` and `model`. Each section serves a specific purpose in describing the AI/ML package components and requirements. - -### `ManifestVersion` - -- **Description**: Specifies the manifest format version. -- **Type**: String -- **Example**: `1.0` - -### `modelkit` - -This section provides general information about the AI/ML project. - -#### `name` - -- **Description**: The name of the AI/ML project. -- **Type**: String - -#### `version` - -- **Description**: The current version of the project. -- **Type**: String -- **Example**: `1.2.3` - -#### `description` - -- **Description**: A brief overview of the project's purpose and capabilities. -- **Type**: String - -#### `authors` - -- **Description**: A list of individuals or entities that have contributed to the project. -- **Type**: Array of Strings - - -#### `code` - -- **Description**: Information about the source code. -- **Type**: Object Array - - `path`: Location of the source code files or directory relative to the context - - `description`: Description of what the code does. - - `license`: SPDX license identifier for the code. - -#### `datasets` - -- **Description**: Information about the datasets used. -- **Type**: Object Array - - `name`: Name of the dataset. - - `path`: Location of the dataset file or directory relative to the context. - - `description`: Overview of the dataset. - - `license`: SPDX license identifier for the dataset. - - `preprocessing`: Reference to preprocessing steps. - -#### `model` - -- **Description**: Details of the trained models included in the package. -- **Type**: Object - - `name`: Name of the model - - `path`: Location of the model file or directory relative to the context - - `framework`: AI/ML framework - - `version`: Version of the model - - `description`: Overview of the model - - `license`: SPDX license identifier for the dataset. - - `training`: - - `dataset`: Name of the dataset - - `parameters`: name value pairs - - `validation`: - - `dataset`: Name of the dataset - - `metrics`: name value pairs - - -## Example - -```yaml -manifestVersion: 1.0 -package: - name: AIProjectName - version: 1.2.3 - description: >- - A brief description of the AI/ML project. - authors: [Author Name, Contributor Name] -code: - - path: src/ - description: Source code for the AI models. - license: Apache-2.0 -datasets: - - name: DatasetName - path: data/dataset.csv - description: Description of the dataset. - license: CC-BY-4.0 - preprocessing: Preprocessing steps. -models: - - name: ModelName - path: models/model.h5 - framework: TensorFlow - version: 1.0 - description: Model description. - license: Apache-2.0 - training: - dataset: DatasetName - parameters: - learning_rate: 0.001 - epochs: 100 - batch_size: 32 - validation: - - dataset: DatasetName - metrics: - accuracy: 0.95 - f1_score: 0.94 -``` - - -## Future Considerations - -This section is for collecting future ideas. - -### `dependencies` - -**This is a possible future section that may be used for creating BOM.** - -- **Description**: Lists the project's external dependencies. -- **Type**: Object Array - - `name`: Name of the dependency. - - `version`: Version of the dependency. - - `license`: SPDX license identifier for the dependency. - -##### Example for dependencies -```yaml - dependencies: - - name: numpy - version: 1.19.2 - license: BSD-3-Clause - - name: pandas - version: 1.1.3 - license: BSD-3-Clause -``` \ No newline at end of file