From cdf76a965480c5586505ca5e60dc59833aa808fd Mon Sep 17 00:00:00 2001
From: dengwenjie <775747758@qq.com>
Date: Thu, 17 Apr 2025 20:58:10 +0800
Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0readme?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
README.md | 117 +++++++++++++-----------------------------------------
1 file changed, 27 insertions(+), 90 deletions(-)
diff --git a/README.md b/README.md
index 714a054..4f1e62e 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,29 @@
🍬JAVA轻量级深度学习算法库,该库致力于构建Java生态与AI模型之间的高效桥梁
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+-------------------------------------------------------------------------------
+
+[**开发文档**](http://doc.numberone.ink)
+
+-------------------------------------------------------------------------------
## 📚简介
@@ -11,6 +34,7 @@
+
## 🚀 核心亮点
针对 Java 开发者在集成智能算法时常见的两大痛点:
@@ -80,6 +104,7 @@
## 📦 安装
+
### 1、环境要求
- Java 版本:**JDK 11或更高版本**
@@ -95,98 +120,10 @@
1.0.8
```
+### 3、完整示例代码
-### 3、人脸检测运行流程
+[示例代码](https://gitee.com/dengwenjie/SmartJavaAI-Demo)
-
-
-
-(1)人脸模型下载(使用人脸相关功能)
-
-如果在有网环境下使用,不需要下载模型(SeetaFace6模型除外)
-
-| 模型名称 | 下载地址 | 文件大小 | 适用场景 | 兼容系统 |
-| :-----------------------: | :----------------------------------------------------------: | :------: | :----------------------------------------: | ------------------- |
-| retinaface | [下载](https://resources.djl.ai/test-models/pytorch/retinaface.zip) | 110MB | 高精度人脸检测 | Windows/Linux/MacOS |
-| ultralightfastgenericface | [下载](https://resources.djl.ai/test-models/pytorch/ultranet.zip) | 1.7MB | 高速人脸检测 | Windows/Linux/MacOS |
-| seetaface6 | [下载](https://pan.baidu.com/s/1hfNacA8ISV2qHrycjOkgqA?pwd=1234) | 288MB | 人脸检测、人脸比对、人脸库注册、人脸库查询 | Windows |
-| facenet | [下载](https://resources.djl.ai/test-models/pytorch/face_feature.zip) | 104MB | 人脸特征提取、人脸比对 | Windows/Linux/MacOS |
-
-(2)人脸库下载(使用人脸库相关功能:人脸注册、人脸查询)
-
-目前仅SeetaFace6人脸算法支持人脸库注册,查询等功能,所以只有使用SeetaFace6模型时才需要下载`face.db`,`face.db` 是 一个SQLite 数据库,程序启动并使用相关功能时会自动操作该数据库,用于存储人脸特征数据及其对应的唯一标识 Key,支持后续的人脸注册、查询和比对等操作。
-
-下载链接: https://pan.baidu.com/s/1DzE1rDkFnjEXQbIasIdFrA?pwd=1234 提取码: 1234
-
-(3)下载示例代码
-
-https://gitee.com/dengwenjie/SmartJavaAI-Demo
-
-📁 src/main/java/smartai/examples/face
-
-└── 📄[RetinaFaceDemo.java](https://gitee.com/dengwenjie/SmartJavaAI-Demo/blob/master/src/main/java/smartai/examples/face/RetinaFaceDemo.java) *(人脸模型:RetinaFace示例代码)*
-
-└── 📄[LightFaceDemo](https://gitee.com/dengwenjie/SmartJavaAI-Demo/blob/master/src/main/java/smartai/examples/face/LightFaceDemo.java) *(人脸模型:UltraLightFastGenericFaceModel示例代码)*
-
-└── 📄[SeetaFace6Demo.java](https://gitee.com/dengwenjie/SmartJavaAI-Demo/blob/master/src/main/java/smartai/examples/face/SeetaFace6Demo.java) *(人脸模型:SeetaFace6示例代码)*
-
-└── 📄[FaceNetDemo.java](https://gitee.com/dengwenjie/SmartJavaAI-Demo/blob/master/src/main/java/smartai/examples/face/FaceNetDemo.java) *(人脸模型:FaceNet示例代码)*
-
-(4)离线使用方法
-
-程序首次运行时,会自动下载所需的底层依赖库到默认的缓存路径。不同操作系统的默认缓存路径如下:
-
-\{user}需要替换成您当前登录的用户名
-
-| | 依赖库及缓存目录 |
-| ------- |-------------------------|
-| windows | C:/Users/\{user}/.djl.ai |
-| linux | /root/.djl.ai |
-| macos | /Users/{user}/.djl.ai |
-
-对于需要在离线环境中使用的情况,可以在联网环境中运行程序一次,确保所需的依赖库已下载。然后,将上述缓存目录复制到离线环境中相同的路径下,即可实现离线使用。
-
-请注意,SeetaFace6 默认支持离线使用,无需上述操作即可在离线环境中运行。
-
-### 4、目标检测运行流程
-
-
-
-
-
-(1)下载示例代码
-
-https://gitee.com/dengwenjie/SmartJavaAI-Demo
-
-📁 src/main/java/smartai/examples/objectdetection
-
-└── 📄[ObjectDetection.java](https://gitee.com/dengwenjie/SmartJavaAI-Demo/blob/master/src/main/java/smartai/examples/objectdetection/ObjectDetection.java) *(目标检测示例代码)*
-
-
-### 5、运行设备
-默认将使用CPU运行模型,如果需要使用GPU,需要在创建模型接口中手动指定运行设备
-
-GPU中运行需要满足如下条件:
-
-(1)安装CUDA v12.4及cuDNN v8.9.7
-
-(2)将缓存目录加入到环境变量中,并删除其他cuda环境变量
-
- windows配置如下:
-
-
-
-
-
-
-(3)示例代码:
-
-```java
-FaceModelConfig config = new FaceModelConfig();
-config.setModelEnum(FaceModelEnum.RETINA_FACE);//人脸模型
-config.setDevice(DeviceEnum.GPU);//指定GPU
-FaceModel faceModel = FaceModelFactory.getInstance().getModel(config);
-```
## 🙏 鸣谢