# AFADS — Advanced Face Age Detection System
Local, on-device face age estimation using InsightFace. Includes demos for webcam (Tkinter), Pygame UI, and a REST API.
## Install
```bash
python -m venv .venv && . .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -e .
# or, after you publish:
# pip install advanced-face-age-recognition-module
```
## Quick Start
```python
from afads import AFADS
engine = AFADS()
print(engine.assess("selfie.jpg", return_dict=True))
```
## Demos
- `python -m afads.extras.afads_webcam_consent` — webcam with consent popup + live overlay
- `python -m afads.extras.pygame_webcam` — Pygame viewer with keys to toggle rules
- `uvicorn afads.extras.afads_server:app --reload` — REST server + simple HTML form
## Rules
- If any age detected → allow
- If age ≥ 18 → require `prob_over_18 ≥ 0.85` (or 0.90 for stricter)
## Privacy
This library runs fully on-device. Ask for consent before using the camera. Do not store images by default.
Raw data
{
"_id": null,
"home_page": null,
"name": "advanced-face-age-recognition-module",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "face, age, estimation, verification, AFADS",
"author": "Your Name",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/3b/1b/344f4208bdadd2ccf46dd6b4ad09c55d6ed6347428abe78d1b2eb7b926cb/advanced_face_age_recognition_module-1.0.0.tar.gz",
"platform": null,
"description": "# AFADS \u2014 Advanced Face Age Detection System\r\n\r\nLocal, on-device face age estimation using InsightFace. Includes demos for webcam (Tkinter), Pygame UI, and a REST API.\r\n\r\n## Install\r\n\r\n```bash\r\npython -m venv .venv && . .venv/bin/activate # Windows: .venv\\Scripts\\activate\r\npip install -e .\r\n# or, after you publish:\r\n# pip install advanced-face-age-recognition-module\r\n```\r\n\r\n## Quick Start\r\n\r\n```python\r\nfrom afads import AFADS\r\nengine = AFADS()\r\nprint(engine.assess(\"selfie.jpg\", return_dict=True))\r\n```\r\n\r\n## Demos\r\n\r\n- `python -m afads.extras.afads_webcam_consent` \u2014 webcam with consent popup + live overlay\r\n- `python -m afads.extras.pygame_webcam` \u2014 Pygame viewer with keys to toggle rules\r\n- `uvicorn afads.extras.afads_server:app --reload` \u2014 REST server + simple HTML form\r\n\r\n## Rules\r\n\r\n- If any age detected \u2192 allow\r\n- If age \u2265 18 \u2192 require `prob_over_18 \u2265 0.85` (or 0.90 for stricter)\r\n\r\n## Privacy\r\n\r\nThis library runs fully on-device. Ask for consent before using the camera. Do not store images by default.\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "AFADS: on-device face age estimation with simple 18+ gating, Tkinter/Pygame/Webcam demos",
"version": "1.0.0",
"project_urls": {
"Homepage": "https://example.com/afads",
"Issues": "https://example.com/afads/issues"
},
"split_keywords": [
"face",
" age",
" estimation",
" verification",
" afads"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "e093f067d862cf66c939d3e2d3aa3bc7c755e71a0c99845e0338647cec68ed74",
"md5": "7f7f9c1210b8c583b54e5f8b74c32487",
"sha256": "86fe403024da032800316c1484d67b4186fbf035217d4f0585e390bc76a45c20"
},
"downloads": -1,
"filename": "advanced_face_age_recognition_module-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7f7f9c1210b8c583b54e5f8b74c32487",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 8197,
"upload_time": "2025-09-08T00:35:29",
"upload_time_iso_8601": "2025-09-08T00:35:29.771345Z",
"url": "https://files.pythonhosted.org/packages/e0/93/f067d862cf66c939d3e2d3aa3bc7c755e71a0c99845e0338647cec68ed74/advanced_face_age_recognition_module-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "3b1b344f4208bdadd2ccf46dd6b4ad09c55d6ed6347428abe78d1b2eb7b926cb",
"md5": "156328fe0fdb95b6f0a9cdb18d6986a5",
"sha256": "4e0e7f173ffd6df2211ed57737d17ab4cbf6dcb671e332cb0ae7b7e71a1f1809"
},
"downloads": -1,
"filename": "advanced_face_age_recognition_module-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "156328fe0fdb95b6f0a9cdb18d6986a5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 6893,
"upload_time": "2025-09-08T00:35:31",
"upload_time_iso_8601": "2025-09-08T00:35:31.206115Z",
"url": "https://files.pythonhosted.org/packages/3b/1b/344f4208bdadd2ccf46dd6b4ad09c55d6ed6347428abe78d1b2eb7b926cb/advanced_face_age_recognition_module-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-08 00:35:31",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "advanced-face-age-recognition-module"
}
JSON