SDK oficial de referencia del protocolo LBH (Lenguaje Binario HormigasAIS).
Implementación pública basada en la especificación LBH_SPEC_v2.0.md.
LBH SDK nace con un objetivo muy claro:
Construir una implementación pública, ligera, estable y reutilizable del protocolo LBH para facilitar la interoperabilidad entre desarrolladores sin exponer la infraestructura crítica de HormigasAIS.
El SDK representa la capa pública del ecosistema.
La infraestructura de producción (Nodo Maestro A16, agentes propietarios, gobernanza, motores internos y demás componentes estratégicos) permanece completamente separada y bajo control exclusivo de HormigasAIS.
- Codificación de paquetes LBH
- Decodificación de paquetes LBH
- Validación de integridad
- Firma HMAC-SHA256
- Verificación HMAC
- API pública estable
- Suite de pruebas automatizadas (16 tests)
Todo paquete LBH sigue la siguiente estructura:
HEADER (8) | TYPE_CODE (8) | LENGTH (8) | PAYLOAD (N)
┌─────────────┬─────────────┬─────────────┬────────────────────────┐
│ HEADER │ TYPE_CODE │ LENGTH │ PAYLOAD │
│ 8 hex │ 8 hex │ 8 hex │ UTF-8 → HEX │
└─────────────┴─────────────┴─────────────┴────────────────────────┘
| TYPE_CODE | Nombre | Descripción |
|---|---|---|
| 5345414C | SEAL | Emisión de sello |
| 56455249 | VERI | Verificación |
| 53594E43 | SYNC | Sincronización |
| 50494E47 | PING | Health Check |
| 4655454C | FUEL | Feromona |
| 41434B4B | ACKK | Confirmación |
| 45525252 | ERRR | Error |
pip install lbh-sdkimport lbh_sdkNo requiere dependencias externas.
Compatible con Python 3.
import lbh_sdk
frame = lbh_sdk.encode_packet(
"41313600",
"5345414C",
"Hola LBH"
)
decoded = lbh_sdk.decode_packet(frame)
print(decoded)lbh_sdk.validate_packet(frame)Resultado esperado:
TrueClave de ejemplo: usa tu propia clave secreta en producción.
digest = lbh_sdk.generate_hmac(
"Hola LBH",
"HormigasAIS"
)
ok = lbh_sdk.validate_hmac(
"Hola LBH",
"HormigasAIS",
digest
)from lbh_sdk.exceptions import InvalidPacketError
try:
packet = lbh_sdk.decode_packet(frame)
except InvalidPacketError as e:
print(e)LBH SDK puede utilizarse para:
- Comunicación entre agentes inteligentes.
- Automatización distribuida.
- Edge Computing.
- Sistemas IoT.
- Integración entre microservicios.
- Protocolos Machine-to-Machine (M2M).
- Automatización industrial.
- Investigación sobre protocolos binarios.
- Desarrollo de herramientas compatibles con el protocolo LBH.
| SDK | Especificación |
|---|---|
| v0.3.x | LBH_SPEC_v2.0 |
Las contribuciones son bienvenidas.
Puedes colaborar mediante:
- Reportar errores.
- Abrir Issues.
- Enviar Pull Requests.
- Mejorar la documentación.
- Crear ejemplos.
- Aumentar la cobertura de pruebas.
Antes de enviar un Pull Request asegúrate de ejecutar:
python3 -m unittest discover testsTodas las pruebas deben finalizar correctamente antes de enviar cambios.
- CHANGELOG.md
- LICENSE
- NOTICE
Repositorio del SDK:
https://github.com/Thrumanshow/lbh-sdk
Repositorio del protocolo:
https://github.com/Thrumanshow/Lenguaje-Binario-HormigasAIS-
Documento principal:
LBH_SPEC_v2.0.md
Versión actual:
v0.3.1
API pública validada mediante 16 pruebas automatizadas.
Publicado: paquete Python en PyPI (lbh-sdk) y SDK JavaScript en npm (lbh-sdk-hormigasais).
- v0.4.0 — Modularización interna
- v1.0.0 — Primera versión estable
Cristhiam Leonardo Hernández Quiñonez (CLHQ)
Fundador de HormigasAIS
Nodo Maestro:
A16 · San Miguel · El Salvador
Copyright © 2026 Cristhiam Leonardo Hernández Quiñonez (CLHQ).
Este SDK se distribuye bajo la Mozilla Public License 2.0 (MPL-2.0). El texto completo está en LICENSE y en https://www.mozilla.org/MPL/2.0/.
Los componentes de producción del ecosistema HormigasAIS (nodo maestro, agentes propietarios, gobernanza y motores internos) no forman parte de este repositorio y no se licencian por este medio.