{"id":51683187,"url":"https://github.com/thrumanshow/lbh-sdk","last_synced_at":"2026-07-15T16:03:24.590Z","repository":{"id":369200351,"uuid":"1288780672","full_name":"Thrumanshow/lbh-sdk","owner":"Thrumanshow","description":"Official Python SDK for the Lenguaje Binario HormigasAIS (LBH) protocol.","archived":false,"fork":false,"pushed_at":"2026-07-04T05:07:47.000Z","size":10,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-04T05:19:48.027Z","etag":null,"topics":["automation","binary-protocol","edge-computing","hmac","hormigasais","iot","lbh","m2m","protocol","python-sdk"],"latest_commit_sha":null,"homepage":"https://thrumanshow.github.io/lbh-sdk/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Thrumanshow.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-07-04T00:55:53.000Z","updated_at":"2026-07-04T05:07:51.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Thrumanshow/lbh-sdk","commit_stats":null,"previous_names":["thrumanshow/lbh-sdk"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Thrumanshow/lbh-sdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Thrumanshow%2Flbh-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Thrumanshow%2Flbh-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Thrumanshow%2Flbh-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Thrumanshow%2Flbh-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Thrumanshow","download_url":"https://codeload.github.com/Thrumanshow/lbh-sdk/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Thrumanshow%2Flbh-sdk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35511400,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-15T02:00:06.706Z","response_time":131,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","binary-protocol","edge-computing","hmac","hormigasais","iot","lbh","m2m","protocol","python-sdk"],"created_at":"2026-07-15T16:03:23.530Z","updated_at":"2026-07-15T16:03:24.583Z","avatar_url":"https://github.com/Thrumanshow.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# LBH SDK\n\n![Version](https://img.shields.io/badge/version-v0.3.0-blue)\n![Status](https://img.shields.io/badge/status-stable-green)\n![License](https://img.shields.io/badge/license-MPL--2.0-orange)\n![Python](https://img.shields.io/badge/python-3.x-blue)\n![Tests](https://img.shields.io/badge/tests-16%20passing-brightgreen)\n\nSDK oficial de referencia del protocolo **LBH (Lenguaje Binario HormigasAIS)**.\n\nImplementación pública basada en la especificación **LBH_SPEC_v2.0.md**.\n\n---\n\n# Filosofía del proyecto\n\nLBH SDK nace con un objetivo muy claro:\n\nConstruir 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.\n\nEl SDK representa la capa pública del ecosistema.\n\nLa 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.\n\n---\n\n# Características\n\n- Codificación de paquetes LBH\n- Decodificación de paquetes LBH\n- Validación de integridad\n- Firma HMAC-SHA256\n- Verificación HMAC\n- API pública estable\n- Suite de pruebas automatizadas (16 tests)\n\n---\n\n# Arquitectura del paquete LBH\n\nTodo paquete LBH sigue la siguiente estructura:\n\n```text\nHEADER (8) | TYPE_CODE (8) | LENGTH (8) | PAYLOAD (N)\n```\n\n```text\n┌─────────────┬─────────────┬─────────────┬────────────────────────┐\n│ HEADER      │ TYPE_CODE   │ LENGTH      │ PAYLOAD                │\n│ 8 hex       │ 8 hex       │ 8 hex       │ UTF-8 → HEX            │\n└─────────────┴─────────────┴─────────────┴────────────────────────┘\n```\n\n---\n\n# TYPE_CODE oficiales\n\n| TYPE_CODE | Nombre | Descripción |\n|-----------|---------|-------------|\n| 5345414C | SEAL | Emisión de sello |\n| 56455249 | VERI | Verificación |\n| 53594E43 | SYNC | Sincronización |\n| 50494E47 | PING | Health Check |\n| 4655454C | FUEL | Feromona |\n| 41434B4B | ACKK | Confirmación |\n| 45525252 | ERRR | Error |\n\n---\n\n# Instalación\n\n```python\nimport lbh_sdk\n```\n\nNo requiere dependencias externas.\n\nCompatible con Python 3.\n\n---\n\n# Ejemplo rápido\n\n```python\nimport lbh_sdk\n\nframe = lbh_sdk.encode_packet(\n    \"41313600\",\n    \"5345414C\",\n    \"Hola LBH\"\n)\n\ndecoded = lbh_sdk.decode_packet(frame)\n\nprint(decoded)\n```\n\n---\n\n# Validación\n\n```python\nlbh_sdk.validate_packet(frame)\n```\n\nResultado esperado:\n\n```python\nTrue\n```\n\n---\n\n# HMAC\n\n```python\ndigest = lbh_sdk.generate_hmac(\n    \"Hola LBH\",\n    \"HormigasAIS\"\n)\n\nok = lbh_sdk.validate_hmac(\n    \"Hola LBH\",\n    \"HormigasAIS\",\n    digest\n)\n```\n\n---\n\n# Manejo de excepciones\n\n```python\nfrom exceptions import InvalidPacketError\n\ntry:\n    packet = lbh_sdk.decode_packet(frame)\n\nexcept InvalidPacketError as e:\n    print(e)\n```\n\n---\n\n# Casos de uso\n\nLBH SDK puede utilizarse para:\n\n- Comunicación entre agentes inteligentes.\n- Automatización distribuida.\n- Edge Computing.\n- Sistemas IoT.\n- Integración entre microservicios.\n- Protocolos Machine-to-Machine (M2M).\n- Automatización industrial.\n- Investigación sobre protocolos binarios.\n- Desarrollo de herramientas compatibles con el protocolo LBH.\n\n---\n\n# Compatibilidad\n\n| SDK | Especificación |\n|------|----------------|\n| v0.3.x | LBH_SPEC_v2.0 |\n\n---\n\n# Cómo contribuir\n\nLas contribuciones son bienvenidas.\n\nPuedes colaborar mediante:\n\n- Reportar errores.\n- Abrir Issues.\n- Enviar Pull Requests.\n- Mejorar la documentación.\n- Crear ejemplos.\n- Aumentar la cobertura de pruebas.\n\nAntes de enviar un Pull Request asegúrate de ejecutar:\n\n```bash\npython3 -m unittest discover tests\n```\n\nTodas las pruebas deben finalizar correctamente antes de enviar cambios.\n\n---\n\n# Documentación relacionada\n\n- CHANGELOG.md\n- LICENSE\n- NOTICE\n\nRepositorio del SDK:\n\nhttps://github.com/Thrumanshow/lbh-sdk\n\nRepositorio del protocolo:\n\nhttps://github.com/Thrumanshow/Lenguaje-Binario-HormigasAIS-\n\nDocumento principal:\n\n**LBH_SPEC_v2.0.md**\n\n---\n\n# Estado del proyecto\n\nVersión actual:\n\n**v0.3.0**\n\nAPI pública validada mediante **16 pruebas automatizadas**.\n\n---\n\n# Roadmap\n\n- v0.4.0 — Modularización interna\n- v0.5.0 — Empaquetado oficial para Python\n- v0.6.0 — SDK JavaScript\n- v1.0.0 — Primera versión estable\n\n---\n\n# Autor\n\n**Cristhiam Leonardo Hernández Quiñonez (CLHQ)**\n\nFundador de HormigasAIS\n\nhttps://hormigasais.com\n\nNodo Maestro:\n\n**A16 · San Miguel · El Salvador**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthrumanshow%2Flbh-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthrumanshow%2Flbh-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthrumanshow%2Flbh-sdk/lists"}