A library to detect anime faces in images.

Navigation

Verified details

These details have been verified by PyPI
Maintainers
Avatar for nya from gravatar.com nya

Unverified details

These details have not been verified by PyPI
Project links
Meta
Classifiers

Project description

python-animeface

PyPI Build License

python-animeface is a Python wrapper of AnimeFace, a library to detect anime character faces in images.

See also the official website of AnimeFace (in Japanese language).

Installation

You can install this module with PIP.

pip install animeface

In case a Python binary package (wheel) is not available for your environment, you need to install libnvxs (the original AnimeFace library) before installing python-animeface. The source code of libnvxs is included in this repository.

cd third_party/nvxs-1.0.2
./configure
make
sudo make install

Usage

>>> import animeface
>>> import PIL.Image
>>> im = PIL.Image.open('/path/to/image.jpg')
>>> faces = animeface.detect(im)
>>> faces
[<animeface.Face likelihood=1.000000 face=<pos=(295, 90; 182, 182)> skin=<color=(253, 226, 212)> hair=<color=(199, 194, 196)> left_eye=<pos=(408, 134; 34, 42), color=(92, 42, 49)> right_eye=<pos=(316, 137; 55, 48), color=(79, 33, 39)> mouth=<pos=(372, 202; 32, 23)> nose=<pos=(397, 186)> chin=<pos=(377, 242)>>]
>>> fp = faces[0].face.pos
>>> print(fp.x, fp.y, fp.width, fp.height)
295 90 182 182

See animeface/__init__.py for the API definitions.

Changelog

2.0.3 (2024-12-28)

  • Fix libnvxs build on modern Mac.
  • Add prebuilts for Python 3.13.
  • Add prebuilts for ARM Mac.
  • Drop prebuilts for Intel Mac.

2.0.2 (2023-12-28)

  • No functional changes.
  • Add prebuilts for Python 3.11-3.12.
  • Drop prebuilts for Python 3.6-3.7.

2.0.0 (2022-04-04)

  • The first modern release.
  • Include prebuilt libnvxs in wheels.
  • Support Python 3.6+.
  • Add type annotations.

License

python-animeface is licenced under Apache License.

The original AnimeFace library is licenced under NYSL.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page