django-camera-kit 0.1.0__py3-none-any.whl

django_camera_kit/templates/django_camera_kit/widgets/document_scanner.html

@@ -0,0 +1,6 @@
+<div class="camera-kit-scanner" data-camera-kit-output="pdf">
+  <input type="{{ widget.type }}" name="{{ widget.name }}"{% include "django/forms/widgets/attrs.html" %}>
+  <button type="button" class="btn btn-outline-primary camera-kit-trigger">
+    Scanner un document
+  </button>
+</div>

django_camera_kit/widgets.py

@@ -0,0 +1,25 @@
+from django import forms
+
+
+class DocumentScannerWidget(forms.FileInput):
+    """FileInput enhanced with in-browser document scanning.
+
+    Detects document edges live (OpenCV.js WASM, fully client-side), lets
+    the user drag the corners when auto-detection misses, and chains
+    multiple pages into a single PDF before writing the result back into
+    this input via the DataTransfer API. No server round-trip and no
+    extra models are required — drop it into any existing FileField or
+    ImageField and it behaves like a regular file input to the rest of
+    the form.
+    """
+
+    template_name = "django_camera_kit/widgets/document_scanner.html"
+
+    class Media:
+        css = {"all": ("django_camera_kit/css/camera_kit.css",)}
+        js = (
+            "django_camera_kit/vendor/opencv.js",
+            "django_camera_kit/vendor/jspdf.umd.min.js",
+            "django_camera_kit/js/camera_kit.js",
+            "django_camera_kit/js/doc_scan.js",
+        )

django_camera_kit-0.1.0.dist-info/METADATA

@@ -0,0 +1,129 @@
+Metadata-Version: 2.4
+Name: django-camera-kit
+Version: 0.1.0
+Summary: Document scanning and KYC face verification widgets for Django
+Author: Altius Academy SNC
+Author-email: Paul Guindo <paulguindo@altius-group.ch>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Altius-Academy-SNC/django-camera-kit
+Project-URL: Documentation, https://altius-academy-snc.github.io/django-camera-kit
+Project-URL: Repository, https://github.com/Altius-Academy-SNC/django-camera-kit
+Project-URL: Issues, https://github.com/Altius-Academy-SNC/django-camera-kit/issues
+Keywords: django,camera,document-scanner,kyc,identity-verification
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.2
+Classifier: Framework :: Django :: 5.0
+Classifier: Framework :: Django :: 5.1
+Classifier: Framework :: Django :: 6.0
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Multimedia :: Graphics :: Capture
+Classifier: Topic :: Security
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: django>=4.2
+Provides-Extra: kyc
+Requires-Dist: djangorestframework>=3.14; extra == "kyc"
+Requires-Dist: pgvector>=0.2; extra == "kyc"
+Requires-Dist: psycopg[binary]>=3.1; extra == "kyc"
+Requires-Dist: insightface>=0.7; extra == "kyc"
+Requires-Dist: onnxruntime>=1.16; extra == "kyc"
+Requires-Dist: pillow>=10.0; extra == "kyc"
+Provides-Extra: dev
+Requires-Dist: djangorestframework>=3.14; extra == "dev"
+Requires-Dist: pgvector>=0.2; extra == "dev"
+Requires-Dist: psycopg[binary]>=3.1; extra == "dev"
+Requires-Dist: insightface>=0.7; extra == "dev"
+Requires-Dist: onnxruntime>=1.16; extra == "dev"
+Requires-Dist: pillow>=10.0; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-django; extra == "dev"
+Dynamic: license-file
+
+# Django Camera Kit
+
+Document scanning and KYC face verification widgets for Django. Drop a real document scanner (live edge detection, manual corner adjustment, multi-page → PDF) into any existing `FileField`, no new models or endpoints required. Add live selfie/ID face verification with a server-side matching endpoint.
+
+[![Tests](https://img.shields.io/github/actions/workflow/status/Altius-Academy-SNC/django-camera-kit/tests.yml?branch=main&label=tests)](https://github.com/Altius-Academy-SNC/django-camera-kit/actions/workflows/tests.yml)
+[![PyPI version](https://img.shields.io/pypi/v/django-camera-kit.svg)](https://pypi.org/project/django-camera-kit/)
+[![License](https://img.shields.io/github/license/Altius-Academy-SNC/django-camera-kit.svg)](LICENSE)
+
+**[Documentation](https://altius-academy-snc.github.io/django-camera-kit)** | **[PyPI](https://pypi.org/project/django-camera-kit/)** | **[Source](https://github.com/Altius-Academy-SNC/django-camera-kit)**
+
+## Status
+
+Document scanning (this package's base install) and KYC identity verification (the `kyc` extra) are both implemented and tested. See the [documentation](https://altius-academy-snc.github.io/django-camera-kit) for the full guide, including the KYC module's security model and known MVP limitations.
+
+## Quick example
+
+```python
+# forms.py — any existing ModelForm, any existing FileField/ImageField
+from django import forms
+from django_camera_kit.widgets import DocumentScannerWidget
+
+from .models import Contract
+
+
+class ContractForm(forms.ModelForm):
+    class Meta:
+        model = Contract
+        fields = ["signed_document"]
+        widgets = {"signed_document": DocumentScannerWidget()}
+```
+
+```html
+<!-- template -->
+{{ form.media }}
+<form method="post" enctype="multipart/form-data">
+  {% csrf_token %}
+  {{ form }}
+  <button type="submit">Enregistrer</button>
+</form>
+```
+
+The widget replaces the plain file input with a "Scanner un document" button. Clicking it opens the camera, detects the document's edges live (OpenCV.js), lets the user drag the corners if detection misses, and supports adding several pages before assembling everything into a single PDF — written back into the same file input via the `DataTransfer` API. From the form's point of view, it's a normal file upload.
+
+## KYC quick example
+
+```bash
+pip install django-camera-kit[kyc]
+```
+
+```python
+# forms.py
+from django import forms
+from django_camera_kit.kyc.widgets import KYCVerificationWidget
+
+class SignupForm(forms.Form):
+    kyc_verification_id = forms.IntegerField(
+        widget=KYCVerificationWidget(verify_url="/kyc/verify/")
+    )
+```
+
+Requires PostgreSQL with the `pgvector` extension. Matching (face embeddings via YuNet + insightface) only ever happens server-side. See [KYC & Identity Verification](https://altius-academy-snc.github.io/django-camera-kit/guides/kyc/) for the full setup and security model.
+
+## Setup
+
+Two vendor JS files are required for the scan widget and not committed to this repo (binary build artifacts, pinned separately) — see [`django_camera_kit/static/django_camera_kit/vendor/README.md`](django_camera_kit/static/django_camera_kit/vendor/README.md) for exact files and versions to download.
+
+Requires Bootstrap (or Bootstrap Native) CSS/JS to already be loaded on the host page for button styling — `django-camera-kit` only ships the structural/positioning CSS for the scanner overlays themselves.
+
+## Roadmap
+
+1. ~~Scan MVP~~ — single page, manual corner adjustment, perspective warp
+2. Auto contour detection refinements
+3. Multi-page flow polish
+4. ~~KYC MVP~~ — selfie + ID capture, embedding comparison, head-movement liveness challenge
+5. Anti-deepfake hardening — server-verified liveness, passive scoring, multiple challenge types
+6. ~~Docs site~~ + PyPI release
+
+## License
+
+MIT

django_camera_kit-0.1.0.dist-info/RECORD

@@ -0,0 +1,32 @@
+django_camera_kit/__init__.py,sha256=kUR5RAFc7HCeiqdlX36dZOHkUI5wI6V_43RpEcD8b-0,22
+django_camera_kit/apps.py,sha256=HBTH0VN0uoxVDjmPIooB-CX9BcuXTqBmlhzuACHGSzE,196
+django_camera_kit/widgets.py,sha256=WFzIxWBuXXcrjSFCmgzIZJZ1BzXHT_qBGpwZs0F_pcU,970
+django_camera_kit/kyc/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_camera_kit/kyc/apps.py,sha256=WDbAHzfDb0lQiq7upKqHRz9XPOomeInw8htH3yB6WSU,240
+django_camera_kit/kyc/conf.py,sha256=snLLKDOXeYRxH90IFEXZ-Fy9Ih-h9fUahop84W6wAsU,1060
+django_camera_kit/kyc/embeddings.py,sha256=eODo2gjnJjAHy5Z12n06DeUb99hfttj2BrKHtTQvTDU,1164
+django_camera_kit/kyc/models.py,sha256=dlqJmGt1Ded1DtCamdRiDSG89MFe7wpnjnYl5tMc-rM,2631
+django_camera_kit/kyc/serializers.py,sha256=OVhJCcWvJtORdS_kM4vjv_llyhFuc0FLm5C5WCdUweg,805
+django_camera_kit/kyc/throttling.py,sha256=Q1mck4X33GeNXSZ6yxIUgeD_Ozw1UcRbSp0ES-k6WQc,684
+django_camera_kit/kyc/urls.py,sha256=6HKIk5_RyNqWL3AvuZns78PJdxLZVK0uJ1xfftb3Wso,172
+django_camera_kit/kyc/views.py,sha256=0F3spbMcBpWOvAwNhKHnVc2SQMXaAcyp1io0SmTXEj0,2650
+django_camera_kit/kyc/widgets.py,sha256=tYeLhqDz72oagM7p4oLFkRyJz-Y6bpvE1qIt6v4lKKc,1442
+django_camera_kit/kyc/migrations/0001_initial.py,sha256=WKUC95RfJgGyxdehNnZCao2QPIDhFdiGJHtZCe3CjGY,2922
+django_camera_kit/kyc/migrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_camera_kit/kyc/static/django_camera_kit/kyc/css/kyc_capture.css,sha256=bKgF0aA3M-SHBjeIiw0Rm6lx98s4wVrTokLq5ODJbgA,1258
+django_camera_kit/kyc/static/django_camera_kit/kyc/js/face_kit.js,sha256=_omlD2IoQZCTA4h9MCZYEvi4g2nrr64bB53abcPyc_I,3432
+django_camera_kit/kyc/static/django_camera_kit/kyc/js/kyc_capture.js,sha256=D7tTENPfcIkUICqDRP1k0kYIwExcaJihPDxjlrU3h-Y,12711
+django_camera_kit/kyc/static/django_camera_kit/kyc/vendor/face_detection_yunet_2023mar.onnx,sha256=jyOD5N08-7RVPqhxgQf8BCMhDclk-fQoBgSATtJVL6Q,232589
+django_camera_kit/kyc/templates/django_camera_kit/kyc/widgets/kyc_verification.html,sha256=kDqG2Uk5kC0OfWz6OwvrU1afi3j28CEL6T8DNdFIRm4,429
+django_camera_kit/static/django_camera_kit/css/camera_kit.css,sha256=98MUQh7g6d12woTgi_Dckm07wVzqID16pTaXA-dhaIg,1851
+django_camera_kit/static/django_camera_kit/js/camera_kit.js,sha256=1I-zDZuapmIMJzfNHxjURKuMuRx-N5oUQKAy70SWiE0,6297
+django_camera_kit/static/django_camera_kit/js/doc_scan.js,sha256=5BzY6HYjtA285e2zhivTp0Y1GvQ25zCF1EyGbJ9XsaM,12005
+django_camera_kit/static/django_camera_kit/vendor/README.md,sha256=Zu-9MhCUo7H2IYfgtIpkIR_OoHPTSxnhp3Q3iLHS5eQ,674
+django_camera_kit/static/django_camera_kit/vendor/jspdf.umd.min.js,sha256=5lUfzcMvCdaFOyxRJtGNAdlEfg2mGKQaEevu4PbCDVQ,420165
+django_camera_kit/static/django_camera_kit/vendor/opencv.js,sha256=uHPIIRQh2nub9BrhV6kj8FpGoLjT5ZBMRMbzrW05ob0,13298869
+django_camera_kit/templates/django_camera_kit/widgets/document_scanner.html,sha256=iCZIxkuT0_itxxIaRVy6bAE3ZpvI8SPpQzrX3dgiGN4,288
+django_camera_kit-0.1.0.dist-info/licenses/LICENSE,sha256=yZSOTYOKvZakrVPaBo6uivMeoc7YcxJnCHBWqTk6cLo,1065
+django_camera_kit-0.1.0.dist-info/METADATA,sha256=5zDO1Hi0EloSooIXZ-t5B8SUS6QqsNhOlbmnQaBGO1U,5948
+django_camera_kit-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+django_camera_kit-0.1.0.dist-info/top_level.txt,sha256=In8oaERMr_l15gHP9o1LiMr-Lbtxj0pNJciKXPsIAn8,18
+django_camera_kit-0.1.0.dist-info/RECORD,,

django_camera_kit-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

django_camera_kit-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AltiusAO
+
+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.

django_camera_kit-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+django_camera_kit