Merge branch 'dev'

Author: whl88

README.md

@@ -47,28 +47,29 @@ We always adhere to the open source spirit, and the launch of the API service ai
 
 Since we open-sourced Heygem, global geeks have illuminated the digital avatar matrix in the code universe, with each commit reconstructing the future! But joy is better shared than enjoyed alone—now we invite all experts to join the "Open Source Co-Creation Plan," empowering everyone with AI creativity and propelling the Chinese AI fleet towards the stars!
 
-1.  Co-Creation Content Direction
+1. Co-Creation Content Direction
 
     Share high-quality videos or articles on Heygem deployment tutorials, optimization guides, and practical cases (Bilibili, Douyin, Xiaohongshu, WeChat Official Accounts, Zhihu, etc.)
 
-2.  Open Source Co-Creation Special Reward Pool (Real Cash Rewards!)
+2. Open Source Co-Creation Special Reward Pool (Real Cash Rewards!)
 
     (1) Basic Rewards
 
-    Content receiving 20-100 likes will be awarded the [Heygem.ai Master Award] and a 20 RMB cash red envelope.
+       Content receiving 20-100 likes will be awarded the [Heygem.ai Master Award] and a 20 RMB cash red envelope.
 
-    Content receiving 100+ likes will be awarded the [Heygem.ai God Award] and a 50 RMB cash red envelope.
+       Content receiving 100+ likes will be awarded the [Heygem.ai God Award] and a 50 RMB cash red envelope.
 
     (2) Special Achievements:
 
         The monthly MVP will unlock the Open Source Hall of Fame digital badge (permanently on-chain).
 
-3.  Participation Method
+3. Participation Method
 
-    Send your creativity to the customer service lady, add a friend with the note "Name+999".
+     Send your creativity to the customer service lady, add a friend with the note "Name+999".
 
 <img src="./README_zh.assets/2025-03-20_14-38-00.jpg" width="50%">
 
+
 ## Outstanding Co-Creation Works Exhibition
 
 [HeyGem Digital Human One-Click Start, 8G Video Memory Available, Model Size 10G, No Need for 100G Hard Disk Space, No Need for D Drive, Based on Docker Single Image, Silicon-Based Open Source](https://www.bilibili.com/video/BV1awQqYZEqB/?spm_id_from=333.337.search-card.all.click&vd_source=618f44772c5dafb47317bb728505d79c)
@@ -190,6 +191,24 @@ Installation using Docker, docker-compose as follows:
 1. Directly download the [officially built installation package](https://github.com/GuijiAI/HeyGem.ai/releases)
 2. Double-click `HeyGem-x.x.x-setup.exe` to install
 
+## Ubuntu 22.04 Installation
+
+### Recommended Configuration
+
+- CPU: 13th Gen Intel Core i5-13400F
+- Memory: 32GB or more (required)
+- Graphics Card: RTX-4070 (ensure you have an NVIDIA graphics card and the driver is correctly installed)
+- Hard Disk: More than 100GB of free space
+
+### Install Docker
+
+> First, check if Docker is installed using `docker --version`. If it is installed, skip the following steps.
+
+1. Directly download the [officially built installation package](https://github.com/GuijiAI/HeyGem.ai/releases) for the Linux version
+2. Double-click `HeyGem-x.x.x.AppImage` to launch, no installation required
+
+  > Reminder: On Ubuntu systems, if you are using the `root` user to access the desktop, double-clicking `HeyGem-x.x.x.AppImage` may not work. You need to execute `./HeyGem-x.x.x.AppImage --no-sandbox` in the terminal, adding the `--no-sandbox` parameter.
+
 ## Open APIs
 
 We have opened APIs for model training and video synthesis. After Docker starts, several ports will be exposed locally, accessible through `http://127.0.0.1`.

README_zh.md

@@ -43,32 +43,34 @@
 
 <img src="./README_zh.assets/cb10263a14cc826e22c2be4bcae01a89.jpg" width="50%">
 
+
 ## 【开源共创·荣耀共享】
 
 自从我们开源了Heygem，全球极客已在代码宇宙中点亮数字分身矩阵，每个commit都在重构未来！但独乐乐不如众乐乐——现在诚邀各路大神加入「开源共创计划」，让AI创意赋能每个人，一起推动中国AI舰队驶向星辰大海！
 
-1.  共创内容方向
+1. 共创内容方向
 
     分享Heygem部署教程、优化指南、实战案例等高质量视频或文章（B站、抖音、小红书、公众号、知乎等）
 
-2.  开源共创特供奖励池（真金白银奉上！）
+2. 开源共创特供奖励池（真金白银奉上！）
 
     （1）基础奖励
 
-    内容获得 20-100 点赞，获评【Heygem.ai 大师奖】及 20 元现金大师🧧
+       内容获得 20-100 点赞，获评【Heygem.ai 大师奖】及 20 元现金大师🧧
 
-    内容获得 100+ 点赞，获评【Heygem.ai 之神奖】及 50 元现金大神🧧
+       内容获得 100+ 点赞，获评【Heygem.ai 之神奖】及 50 元现金大神🧧
 
     （2）特殊成就：
 
         月度MVP将解锁开源名人堂数字勋章（永久上链）
 
-3.  参与方式
+3. 参与方式
 
-    你的创意发送至至客服小姐姐，加好友备注“姓名+999”
+     你的创意发送至至客服小姐姐，加好友备注“姓名+999”
 
 <img src="./README_zh.assets/2025-03-20_14-38-00.jpg" width="50%">
 
+
 ## 共创优秀作品展
 
 [HeyGem数字人一键启动,8G显存可用,模型体积10G,不需要100G硬盘空间,不需要d盘,基于Docker单镜像,硅基开源](https://www.bilibili.com/video/BV1awQqYZEqB/?spm_id_from=333.337.search-card.all.click&vd_source=618f44772c5dafb47317bb728505d79c)
@@ -190,6 +192,82 @@ Heygem是一款专为Windows系统设计的全离线视频合成工具，它能
 1. 直接下载[官方构建的安装包](https://github.com/GuijiAI/HeyGem.ai/releases)
 2. 双击`HeyGem-x.x.x-setup.exe`即可安装
 
+## Ubuntu22.04 安装
+
+### 推荐配置
+
+ - CPU：第13代英特尔酷睿 i5-13400F
+ - 内存：32G及以上（必要）
+ - 显卡：rtx-4070（确保有英伟达显卡，并正确安装显卡驱动）
+ - 硬盘：空闲空间大于 100G
+
+### 安装 Docker
+
+> 先用`docker --version`检查是否安装了docker，如果安装了，则跳过以下步骤
+
+```bash
+sudo apt update
+sudo apt install docker.io
+sudo apt install docker-compose
+```
+
+### 安装显卡驱动
+
+1. 参考官方文档安装显卡驱动[https://www.nvidia.cn/drivers/lookup/](https://www.nvidia.cn/drivers/lookup/)
+
+    > 安装后执行`nvidia-smi`命令，如果显示显卡信息，则安装成功
+
+2. 安装 NVIDIA Container Toolkit
+
+    NVIDIA Container Toolkit 是 Docker 使用 NVIDIA GPU 的必要工具。安装步骤如下：
+    - 添加 NVIDIA 包仓库：
+      ```bash
+      distribution=$(. /etc/os-release;echo $ID$VERSION_ID) \
+        && curl -s -L https://nvidia.github.io/libnvidia-container/gpgkey | sudo apt-key add - \
+        && curl -s -L https://nvidia.github.io/libnvidia-container/$distribution/libnvidia-container.list | sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list
+      ```
+    - 更新包列表并安装工具包：
+      ```bash
+        sudo apt-get update
+        sudo apt-get install -y nvidia-container-toolkit
+      ```
+    - 配置 Docker 使用 NVIDIA 运行时：
+      ```bash
+        sudo nvidia-ctk runtime configure --runtime=docker
+      ```
+    - 重启 Docker 服务：
+      ```bash
+        sudo systemctl restart docker
+      ```
+
+### 安装服务端
+
+```bash
+cd /deploy
+docker-compose -f docker-compose-linux.yml up -d
+```
+
+> 与windows上拉镜像一样，如果下载太慢，需要指定国内镜像源方法是在`/etc/docker/daemon.json`文件中添加：
+>
+> ```json
+> {
+>   "registry-mirrors": [
+>     "https://hub.fast360.xyz",
+>     "https://hub.littlediary.cn",
+>     "https://docker.kejilion.pro",
+>     "https://docker.1panelproxy.com"
+>   ]
+> }
+> ```
+> 上面四个镜像源，随着时间推移，可能会有变化，请自行搜索最新的镜像源
+
+### 客户端
+
+1. 直接下载[官方构建的安装包](https://github.com/GuijiAI/HeyGem.ai/releases)的Linux版本
+2. 双击`HeyGem-x.x.x.AppImage`即可启动，无需安装
+
+  > 提醒：在Ubuntu系统中，如果您使用`root`用户进入桌面，直接双击`HeyGem-x.x.x.AppImage`可能运行不了，需要在命令行终端中执行`./HeyGem-x.x.x.AppImage --no-sandbox`,加上`--no-sandbox`参数即可。
+
 ## 开放 API
 
 我们开放了模特训练和视频合成的API，Docker 启动后会在本地暴露几个端口，通过`http://127.0.0.1`可以调用。