update readme

README.md

@@ -11,15 +11,22 @@ license: mit
 short_description: extracts face features, gender, age, landmarks, ...
 ---
 
-## Unofficial FaceAnalysis Implementation
+## Unofficial [FaceAnalysis](https://huggingface.co/spaces/leonelhs/FaceAnalysis) Implementation
 
-This lightweight FaceAnalysis implementation contains only the core components
-required for quick deployment or integration into other projects.
+FaceAnalysis is the core library used for facial region detection and extraction.
+Future contributors and maintainers should review the official or reference
+implementations for details and updates:
+-[Surce face_analysis.py](https://github.com/deepinsight/insightface/blob/master/python-package/insightface/app/face_analysis.py)
+
+The goal of this project is to enable quick integration into other systems
+while minimizing external library dependencies.
+For users who prefer a ready-to-use solution, consider installing the full package:
+pip install insightface
 
 ## Acknowledgments
 
 This work preserves key functionality from the original authors:
-- [DeepInsight](https://github.com/deepinsight/insightface)
+- [Deepinsight Insightface](https://github.com/deepinsight/insightface)
 
 ## Contact
 

face_analysis.py

@@ -1,8 +1,40 @@
+#######################################################################################
+#
+# MIT License
+#
+# Copyright (c) [2025] [leonelhs@gmail.com]
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#
+#
+#######################################################################################
+#
 # FaceAnalysis is the core library used for facial region detection and extraction.
 # Future contributors and maintainers should review the official or reference
 # implementations for details and updates:
 # https://github.com/deepinsight/insightface/blob/master/python-package/insightface/app/face_analysis.py
 #
+# The goal of this project is to enable quick integration into other systems
+# while minimizing external library dependencies.
+# For users who prefer a ready-to-use solution, consider installing the full package:
+# pip install insightface
+#
 # Demo: https://huggingface.co/spaces/leonelhs/FaceAnalysis
 
 

playground.py

@@ -1,5 +1,6 @@
 import cv2
-
+# install by "pip install insightface"
+#from insightface.app import FaceAnalysis
 from face_analysis import FaceAnalysis
 
 face_analyser = FaceAnalysis()