# kinyx-AI

**Repository Path**: Kinyx/kinyx-AI

## Basic Information

- **Project Name**: kinyx-AI
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-20
- **Last Updated**: 2026-02-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 安装`CUDA`
> AI运行环境
>
> 与显卡型号直接相关
>
> https://developer.nvidia.com/cuda-toolkit-archive

## 查看`CUDA`信息
```shell
nvcc --version
```
```
nvcc: NVIDIA (R) Cuda compiler driver
Copyright (c) 2005-2025 NVIDIA Corporation
Built on Wed_Jan_15_19:38:46_Pacific_Standard_Time_2025
Cuda compilation tools, release 12.8, V12.8.61
Build cuda_12.8.r12.8/compiler.35404655_0
```
> 如上可知，本机`CUDA`版本为`V12.8.61`。



# 安装`git`
> 下载源代码
>
> https://git-scm.cn/

## 下载项目

### 下载主项目
```shell
git clone https://....git
```

### 下载子项目
```shell
git submodule update --init --remote
```

### 下载子项目 - 替代方案
```shell
git clone https://....git %submodule_name%
```



# 安装`python`
> 源代码运行环境
>
> https://www.python.org/

## 查看`python`版本
```shell
python --version
```

## 安装`modelscope`
```shell
pip3 install modelscope
```

## 安装`huggingface`
```shell
pip3 install huggingface_hub
```



# 安装`conda`
> 隔离环境变量
>
> https://www.anaconda.com/
>
> miniconda

## 创建`conda`环境
```shell
conda create --name %ENV_NAME% python=%python_version% -y
```

## 创建`conda`环境 - 替代方案
```shell
conda create --clone %exist_env_name% -n %ENV_NAME% -y
```

### 查看`conda`环境列表
```shell
conda env list
```

### 切换`conda`环境
```shell
conda activate %ENV_NAME%
```

### 备份`conda`环境
```shell
conda env export --name %ENV_NAME% > %ENV_NAME%.yaml
```

### 还原`conda`环境
```shell
conda env create --name %ENV_NAME% -f %ENV_NAME%.yaml
```

### 删除`conda`环境
```shell
conda env remove -n %ENV_NAME% -y
```

### 在`conda`环境中查看`python`版本
```shell
python --version
```



# 安装`ffmpeg`
> 音频视频处理工具
>
> https://www.ffmpeg.org/download.html
>
> https://www.gyan.dev/ffmpeg/builds/


# 安装项目依赖

## 安装`CUDA`+`python`对应版本的`torch`
> https://pytorch.org/
```shell
pip3 install torch==2.8.0 torchvision==0.23.0 torchaudio==2.8.0 --index-url https://download.pytorch.org/whl/cu128
pip3 install torch==2.9.1 torchvision==0.24.1 torchaudio==2.9.1 --index-url https://download.pytorch.org/whl/cu128
```

## 安装其它包
```shell
pip3 install -r requirements.txt
```

## 模型

### 下载模型
```shell
python kinyx/launcher/download_model_modelscope.py --namespace=??? --repository_name=??? --revision=main
```
```shell
python kinyx/launcher/download_model_huggingface.py --namespace=??? --repository_name=??? --revision=main
```

### 链接模型
```shell
mklink    "src_file" "dst_file"
mklink /D "src_dir" "dst_dir"
```

# 初始化项目
> 已实现项目在`CMDs`目录中会创建模型对应的`初始化项目.cmd`文件，使用`管理员权限`执行该文件即可。当该文件执行全部正确完成后，在同文件夹内会生成一些`启动文件-*@*.cmd`，执行这些`启动文件`即可使用对应的模型相关功能。