https://github.com/antonygiomarxdev/biometric
https://github.com/antonygiomarxdev/biometric
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/antonygiomarxdev/biometric
- Owner: antonygiomarxdev
- Created: 2024-03-29T03:38:34.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-07-21T23:18:32.000Z (11 months ago)
- Last Synced: 2025-07-21T23:27:21.388Z (11 months ago)
- Language: Python
- Size: 68.4 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# BioSecure Gov - Sistema Biométrico de Huellas Dactilares
Este repositorio contiene un sistema completo de identificación biométrica diseñado para uso gubernamental y forense. Implementa una arquitectura moderna de monorepo con separación clara entre backend (Python/FastAPI) y frontend (React/TypeScript).
## Estructura del Proyecto
El proyecto está organizado como un monorepo:
- **`apps/backend/`**: API REST en Python con FastAPI. Contiene toda la lógica de procesamiento de huellas, extracción de minucias y algoritmos de coincidencia (matching).
- **`apps/frontend/`**: Aplicación web moderna en React con TypeScript y Tailwind CSS. Proporciona una interfaz visual para escaneo, registro e identificación.
- **`data/`**: Directorio compartido para almacenamiento de datos (imágenes de huellas, etc.).
- **`docs/`**: Documentación técnica detallada del proyecto.
## Requisitos Previos
- Docker y Docker Compose
- Python 3.12+ (para desarrollo local del backend)
- Node.js 20+ (para desarrollo local del frontend)
- `uv` (gestor de paquetes de Python)
## Inicio Rápido
### Windows (Recomendado)
Simplemente ejecute el script interactivo:
```cmd
run.bat
```
Este script le permitirá iniciar todo el sistema con Docker, o ejecutar componentes individuales localmente.
### Docker Manual
```bash
make docker-up
# O:
docker-compose up --build
```
Esto levantará:
- **Frontend**: http://localhost:5173
- **Backend API**: http://localhost:8000
- **Base de Datos**: PostgreSQL con pgvector (puerto 5434)
## Desarrollo Local
### Backend
```bash
make install # Instalar dependencias
make api # Iniciar servidor de desarrollo
make test # Ejecutar pruebas
```
### Frontend
```bash
make frontend-install # Instalar dependencias
make frontend # Iniciar servidor de desarrollo
```
## Documentación
Consulte el directorio `docs/` para guías detalladas:
- `QUICKSTART.md`: Guía de inicio rápido.
- `ARCHITECTURE.md`: Detalles de la arquitectura del sistema.
- `GPU_SETUP.md`: Configuración para aceleración por GPU.