# 모델 관리

모델은 학습, 서빙, 평가 등에 사용되는 AI 모델을 체계적으로 관리하는 기능입니다. 모델 파일을 업로드하고 리비전별로 관리하여 버전 관리와 배포를 효율적으로 수행할 수 있습니다.

## 모델 목록

<figure><img src="/files/16BNzWmVITQQUPLUhV1W" alt="모델 목록"><figcaption><p>모델 목록 화면</p></figcaption></figure>

* 모델 메뉴에서 생성된 모델 목록을 확인할 수 있습니다.
* 목록에서 ID, 모델 유형, 모델명, 제작자, 관리 그룹, 등록일시 정보를 확인할 수 있습니다.
* 모델 유형에는 LLM, VLM, T2I, I2I 등이 있습니다.

## 모델 생성하기

<figure><img src="/files/yFaPcCLmSM20sVHixX9M" alt="모델 생성"><figcaption><p>모델 생성 화면</p></figcaption></figure>

* **모델 생성** 버튼을 클릭합니다.
* 모델 생성을 위한 정보를 입력합니다:
  * **모델 유형**: LLM, VLM, T2I, I2I 등에서 선택합니다.
  * **제목**: 모델의 이름을 입력합니다.
  * **상세 설명**: 모델의 특징이나 용도를 설명합니다.
  * **관리 그룹**: 모델을 관리할 그룹을 선택합니다.
  * **파일 업로드**: 모델 파일을 드래그하여 업로드하거나 클릭하여 선택합니다.

### 대용량 파일 업로드 시 참고사항

대용량 모델 파일의 경우 웹 인터페이스를 통한 업로드가 어려울 수 있습니다. 이 경우 다음 방법으로 빠르게 모델을 등록할 수 있습니다.

#### GenOS 모델 빠르게 등록하는 방법

1. **더미 파일로 모델 생성**
   * 모델 탭에서 모델 생성을 진행합니다.
   * 이때 업로드하는 파일은 작은 크기의 dummy file을 사용합니다.
2. **서버 접속 및 더미 파일 삭제**
   * `{cluster-name}-worker` 서버에 접속합니다.
   * 다음 경로로 이동합니다:

     ```bash
     cd /fsrepo/{cluster-name}/llmops/llmops-nfs-root/models/{model_id}/{revision_id}
     ```
   * 업로드했던 dummy file을 삭제합니다.
   * 이때 `{model_id}`는 GenOS에 생성한 모델의 ID입니다 (예: 1, 2, ...).
3. **실제 모델 파일 복사**
   * `/data/models/{model_name}` 또는 `/fsrepo/models/{model_name}` 디렉토리 안에 있는 모든 파일을 복사합니다:

     ```bash
     cp /data/models/{model_name}/. .
     ```
4. **데이터베이스 수정**
   * 위 내용대로 업로드 진행한 항목에 대해서는 **MariaDB 목록 수정이 필요**합니다.
   * 파일 크기 및 경로 정보를 실제 파일에 맞게 업데이트해야 합니다.

> ⚠️ **주의사항**
>
> * 이 방법은 대용량 파일 업로드 시에만 사용하세요.
> * 서버 접속 권한이 필요합니다.
> * 파일 경로와 권한을 정확히 확인하세요.
> * 데이터베이스 수정 시 신중하게 진행하세요.

## 모델 상세

<figure><img src="/files/pj9vRLzcy2utAjkSzyB1" alt="모델 상세"><figcaption><p>모델 상세 화면</p></figcaption></figure>

* 모델 목록에서 항목을 더블 클릭하면 상세 페이지로 이동합니다.
* 모델 상세 페이지에는 **기본 정보** 탭과 **리비전 목록** 탭이 있습니다.
* 기본 정보에서 모델 유형, 제목, 설명, 관리 그룹 정보를 확인할 수 있습니다.

## 모델 리비전 추가하기

<figure><img src="/files/JyDPyyjTeUtGFrpsa3fd" alt="모델 리비전 추가"><figcaption><p>모델 리비전 추가</p></figcaption></figure>

* 모델 상세 페이지에서 **리비전 추가** 버튼을 클릭합니다.
* 리비전을 통해 모델의 버전을 관리할 수 있습니다.
* 새로운 모델 파일을 업로드하여 리비전을 생성합니다.

## 리비전 목록

<figure><img src="/files/qYXAEssB9HeK1I4l7PAA" alt="모델 리비전 목록"><figcaption><p>모델 리비전 목록</p></figcaption></figure>

* **리비전 목록** 탭에서 생성된 모든 리비전을 확인할 수 있습니다.
* 각 리비전의 ID, 파일명, 파일 크기, 제작자, 등록일시를 확인할 수 있습니다.
* 리비전을 더블 클릭하면 상세 페이지로 이동합니다.

## 리비전 상세

<figure><img src="/files/YcKytALY2b8IIYi6wdJj" alt="모델 리비전 상세"><figcaption><p>모델 리비전 상세 화면</p></figcaption></figure>

* 리비전 상세 페이지에서 해당 버전의 모델 정보를 확인할 수 있습니다.
* 파일 정보, 크기, 등록일시 등의 세부 정보를 확인할 수 있습니다.
* 필요한 경우 모델 파일을 다운로드하거나 삭제할 수 있습니다.

## 모델 활용

생성된 모델은 다음과 같은 용도로 활용할 수 있습니다:

* **모델 서빙**: 학습된 모델을 서빙하여 추론 API를 제공할 수 있습니다.
* **모델 학습**: 기반 모델로 사용하여 파인튜닝을 진행할 수 있습니다.
* **모델 평가**: 평가 데이터셋을 사용하여 모델 성능을 측정할 수 있습니다.
* **버전 관리**: 리비전을 통해 모델의 변경 이력을 추적하고 관리할 수 있습니다.

리비전 관리를 통해 모델의 변경 이력을 추적하고, 필요한 경우 이전 버전으로 되돌릴 수 있습니다.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://genos-docs.gitbook.io/default/v1.7.5.1/basic-tutorials/guides/model.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.