# Holobit SDK - Documentación Oficial
## 📌 Introducción
El **Holobit SDK** es un kit de desarrollo diseñado para la transpilación y ejecución de código holográfico cuántico. Su arquitectura multinivel permite trabajar con diferentes niveles de abstracción, optimizando el rendimiento en múltiples arquitecturas de hardware.
## 🔹 Características Principales
- **Transpilador Cuántico Holográfico**: Convierte código HoloLang en código máquina optimizado para arquitecturas x86, ARM y RISC-V.
- **Optimización Avanzada**: Reduce instrucciones redundantes y reutiliza registros para maximizar la eficiencia.
- **Ejecución Multinivel**: Soporte para bajo, medio y alto nivel en la programación holográfica.
- **Compatibilidad con Múltiples Arquitecturas**: x86, ARM y RISC-V.
## 📥 Instalación
Para instalar el SDK Holobit, sigue los siguientes pasos:
### 🔹 Requisitos Previos
- **Python >=3.10** (versión mínima recomendada)
- **pip** actualizado
- **Git (opcional, pero recomendado)**
### 🔹 Instalación desde GitHub
```bash
# Clonar el repositorio
git clone https://github.com/usuario/holobit_sdk.git
cd holobit_sdk
# Instalar dependencias
pip install -r requirements_optional.txt
# Para tareas de desarrollo instala también las dependencias de
# linting y cobertura
pip install -r requirements_dev.txt
```
## 🚀 Uso del SDK
### 🔹 Transpilación de Código HoloLang
Para transpilar un archivo de código holográfico:
```bash
holobit-transpiler --input archivo.holo --arch x86
```
También puedes ejecutarlo con el módulo de Python:
```bash
python -m holobit_sdk.transpiler.machine_code_transpiler --input archivo.holo --arch x86
```
Esto generará un archivo con el código máquina optimizado para la arquitectura especificada.
### 🔹 Ejemplo de Uso en Código
```python
from transpiler.machine_code_transpiler import MachineCodeTranspiler
transpiler = MachineCodeTranspiler("x86")
instruccion = "ADD H1 H2"
codigo_maquina = transpiler.transpile(instruccion)
print(codigo_maquina) # ADD H1, H2 ; Registro reutilizado
```
Puedes encontrar más demostraciones en el directorio `examples/`.
### 🔹 Ejecución de HoloLang desde la línea de comandos
Puedes ejecutar código HoloLang directamente con el comando `hololang`:
```bash
hololang -c "CREAR H1 (0.1, 0.2, 0.3)" -c "IMPRIMIR H1"
```
O bien pasar un archivo con varias instrucciones:
```bash
hololang --file programa.holo --arch x86
```
Esto mostrará por pantalla el resultado de cada línea procesada.
### 🔹 Máquina Virtual del Ensamblador
El módulo `assembler.virtual_machine` permite ejecutar instrucciones holográficas en un entorno controlado.
```python
from assembler.virtual_machine import AssemblerVM
vm = AssemblerVM()
programa = ["CREAR Q1 (0.1, 0.2, 0.3)", "CREAR Q2 (0.4, 0.5, 0.6)", "CREAR H1 {Q1, Q2}", "ROT H1 z 90"]
vm.run_program(programa)
```
Las instrucciones del ASIIC pueden escribirse con cualquier combinación de mayúsculas y minúsculas. Por ejemplo, `rotar`, `Rotar` y `ROTAR` se interpretan de la misma manera.
### 🔹 Simulación de Holobits
El simulador `HologramSimulator` permite mover y rotar Holobits paso a paso,
y visualizar cada estado en 3D.
```python
from holobit_sdk.quantum_holocron.core.hologram_simulator import HologramSimulator
sim = HologramSimulator()
pasos = [{"traslacion": (0.1, 0, 0), "rotacion": ("z", 15)}]
sim.animate(holobit, pasos)
```
## 🔬 Arquitectura Interna del SDK
El SDK Holobit está estructurado en varios niveles:
1. **Nivel Bajo**: Manejo directo de registros y memoria holográfica.
2. **Nivel Medio**: Procesamiento cuántico holográfico.
3. **Nivel Alto**: Lenguaje de programación HoloLang y compilador asociado.
## 📖 Referencia Técnica
- **Módulo `transpiler`**: Contiene el transpilador de código holográfico a código máquina.
- **Módulo `execution`**: Maneja la ejecución de código transpilado en arquitecturas objetivo.
- **Módulo `debugger`**: Herramientas de depuración y análisis de código transpilado.
## 📄 Ejemplos de Código
Los ejemplos del SDK se encuentran en el directorio `examples/` y pueden
ejecutarse directamente con Python. Por ejemplo:
```bash
python examples/holobit_demo.py
python examples/hololang_compiler.py
python examples/hologram_simulation.py
```
Cada script muestra una funcionalidad concreta del SDK. También puedes
utilizar el transpilador de forma manual:
```bash
holobit-transpiler --input ejemplo.holo --arch x86
```
O bien con el módulo de Python:
```bash
python -m holobit_sdk.transpiler.machine_code_transpiler --input ejemplo.holo --arch x86
```
## 📦 Despliegue y Distribución
El SDK Holobit será empaquetado y distribuido a través de **GitHub Releases** y **PyPI**.
### 🔹 Construcción del Paquete
```bash
python setup.py sdist bdist_wheel
```
### 🔹 Publicación en PyPI
```bash
pip install twine
# Subir el paquete
python -m twine upload dist/*
```
## 🧪 Pruebas
Para ejecutar las pruebas unitarias del proyecto debes instalar las dependencias opcionales.
La suite completa requiere la librería `qiskit`, incluida en este archivo, para ejecutar las pruebas de integración cuántica:
```bash
pip install -r requirements_optional.txt
```
Si además deseas comprobar la cobertura de código instala las dependencias de desarrollo y ejecuta `coverage`:
```bash
pip install -r requirements_dev.txt
```
Luego ejecuta `flake8` para verificar el estilo y `coverage run` junto con `pytest`:
```bash
flake8
coverage run -m pytest
```
Este repositorio cuenta con un flujo de **Integración Continua** en GitHub Actions que instala estas dependencias y ejecuta las pruebas en cada *push* y *pull request*.
## 🛠 Mantenimiento y Contribución
Si deseas contribuir al SDK Holobit, puedes hacer un **fork** del repositorio y enviar un **pull request** con tus mejoras.
## 📧 Contacto y Soporte
Para cualquier consulta, reportes de errores o contribuciones, puedes contactarnos en **adolfogonzal@gmail.com** o a través del repositorio en **GitHub**.
---
📌 **Holobit SDK - Computación Cuántica Holográfica para el Futuro** 🚀
Raw data
{
"_id": null,
"home_page": "https://github.com/Alphonsus411/holobit_SDK",
"name": "holobit-sdk",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": null,
"author": "Adolfo Gonz\u00e1lez Hern\u00e1ndez",
"author_email": "Adolfo Gonz\u00e1lez Hern\u00e1ndez <adolfogonzal@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/16/b6/911429d270446baf0ca2e1da4213d2261928e57f69c35c28e39dfd6d1b37/holobit_sdk-1.0.8.tar.gz",
"platform": null,
"description": "\r\n# Holobit SDK - Documentaci\u00f3n Oficial\r\n\r\n## \ud83d\udccc Introducci\u00f3n\r\nEl **Holobit SDK** es un kit de desarrollo dise\u00f1ado para la transpilaci\u00f3n y ejecuci\u00f3n de c\u00f3digo hologr\u00e1fico cu\u00e1ntico. Su arquitectura multinivel permite trabajar con diferentes niveles de abstracci\u00f3n, optimizando el rendimiento en m\u00faltiples arquitecturas de hardware.\r\n\r\n## \ud83d\udd39 Caracter\u00edsticas Principales\r\n- **Transpilador Cu\u00e1ntico Hologr\u00e1fico**: Convierte c\u00f3digo HoloLang en c\u00f3digo m\u00e1quina optimizado para arquitecturas x86, ARM y RISC-V.\r\n- **Optimizaci\u00f3n Avanzada**: Reduce instrucciones redundantes y reutiliza registros para maximizar la eficiencia.\r\n- **Ejecuci\u00f3n Multinivel**: Soporte para bajo, medio y alto nivel en la programaci\u00f3n hologr\u00e1fica.\r\n- **Compatibilidad con M\u00faltiples Arquitecturas**: x86, ARM y RISC-V.\r\n\r\n## \ud83d\udce5 Instalaci\u00f3n\r\nPara instalar el SDK Holobit, sigue los siguientes pasos:\r\n\r\n### \ud83d\udd39 Requisitos Previos\r\n- **Python >=3.10** (versi\u00f3n m\u00ednima recomendada)\r\n- **pip** actualizado\r\n- **Git (opcional, pero recomendado)**\r\n\r\n### \ud83d\udd39 Instalaci\u00f3n desde GitHub\r\n```bash\r\n# Clonar el repositorio\r\ngit clone https://github.com/usuario/holobit_sdk.git\r\ncd holobit_sdk\r\n\r\n# Instalar dependencias\r\npip install -r requirements_optional.txt\r\n# Para tareas de desarrollo instala tambi\u00e9n las dependencias de \r\n# linting y cobertura\r\npip install -r requirements_dev.txt\r\n```\r\n\r\n## \ud83d\ude80 Uso del SDK\r\n### \ud83d\udd39 Transpilaci\u00f3n de C\u00f3digo HoloLang\r\nPara transpilar un archivo de c\u00f3digo hologr\u00e1fico:\r\n```bash\r\nholobit-transpiler --input archivo.holo --arch x86\r\n```\r\nTambi\u00e9n puedes ejecutarlo con el m\u00f3dulo de Python:\r\n```bash\r\npython -m holobit_sdk.transpiler.machine_code_transpiler --input archivo.holo --arch x86\r\n```\r\nEsto generar\u00e1 un archivo con el c\u00f3digo m\u00e1quina optimizado para la arquitectura especificada.\r\n\r\n### \ud83d\udd39 Ejemplo de Uso en C\u00f3digo\r\n```python\r\nfrom transpiler.machine_code_transpiler import MachineCodeTranspiler\r\n\r\ntranspiler = MachineCodeTranspiler(\"x86\")\r\ninstruccion = \"ADD H1 H2\"\r\ncodigo_maquina = transpiler.transpile(instruccion)\r\nprint(codigo_maquina) # ADD H1, H2 ; Registro reutilizado\r\n```\r\n\r\nPuedes encontrar m\u00e1s demostraciones en el directorio `examples/`.\r\n\r\n### \ud83d\udd39 Ejecuci\u00f3n de HoloLang desde la l\u00ednea de comandos\r\nPuedes ejecutar c\u00f3digo HoloLang directamente con el comando `hololang`:\r\n```bash\r\nhololang -c \"CREAR H1 (0.1, 0.2, 0.3)\" -c \"IMPRIMIR H1\"\r\n```\r\nO bien pasar un archivo con varias instrucciones:\r\n```bash\r\nhololang --file programa.holo --arch x86\r\n```\r\nEsto mostrar\u00e1 por pantalla el resultado de cada l\u00ednea procesada.\r\n\r\n### \ud83d\udd39 M\u00e1quina Virtual del Ensamblador\r\nEl m\u00f3dulo `assembler.virtual_machine` permite ejecutar instrucciones hologr\u00e1ficas en un entorno controlado.\r\n```python\r\nfrom assembler.virtual_machine import AssemblerVM\r\n\r\nvm = AssemblerVM()\r\nprograma = [\"CREAR Q1 (0.1, 0.2, 0.3)\", \"CREAR Q2 (0.4, 0.5, 0.6)\", \"CREAR H1 {Q1, Q2}\", \"ROT H1 z 90\"]\r\nvm.run_program(programa)\r\n```\r\nLas instrucciones del ASIIC pueden escribirse con cualquier combinaci\u00f3n de may\u00fasculas y min\u00fasculas. Por ejemplo, `rotar`, `Rotar` y `ROTAR` se interpretan de la misma manera.\r\n### \ud83d\udd39 Simulaci\u00f3n de Holobits\r\nEl simulador `HologramSimulator` permite mover y rotar Holobits paso a paso,\r\ny visualizar cada estado en 3D.\r\n```python\r\nfrom holobit_sdk.quantum_holocron.core.hologram_simulator import HologramSimulator\r\nsim = HologramSimulator()\r\npasos = [{\"traslacion\": (0.1, 0, 0), \"rotacion\": (\"z\", 15)}]\r\nsim.animate(holobit, pasos)\r\n```\r\n## \ud83d\udd2c Arquitectura Interna del SDK\r\nEl SDK Holobit est\u00e1 estructurado en varios niveles:\r\n1. **Nivel Bajo**: Manejo directo de registros y memoria hologr\u00e1fica.\r\n2. **Nivel Medio**: Procesamiento cu\u00e1ntico hologr\u00e1fico.\r\n3. **Nivel Alto**: Lenguaje de programaci\u00f3n HoloLang y compilador asociado.\r\n\r\n## \ud83d\udcd6 Referencia T\u00e9cnica\r\n- **M\u00f3dulo `transpiler`**: Contiene el transpilador de c\u00f3digo hologr\u00e1fico a c\u00f3digo m\u00e1quina.\r\n- **M\u00f3dulo `execution`**: Maneja la ejecuci\u00f3n de c\u00f3digo transpilado en arquitecturas objetivo.\r\n- **M\u00f3dulo `debugger`**: Herramientas de depuraci\u00f3n y an\u00e1lisis de c\u00f3digo transpilado.\r\n\r\n## \ud83d\udcc4 Ejemplos de C\u00f3digo\r\nLos ejemplos del SDK se encuentran en el directorio `examples/` y pueden\r\nejecutarse directamente con Python. Por ejemplo:\r\n```bash\r\npython examples/holobit_demo.py\r\npython examples/hololang_compiler.py\r\npython examples/hologram_simulation.py\r\n```\r\nCada script muestra una funcionalidad concreta del SDK. Tambi\u00e9n puedes\r\nutilizar el transpilador de forma manual:\r\n```bash\r\nholobit-transpiler --input ejemplo.holo --arch x86\r\n```\r\nO bien con el m\u00f3dulo de Python:\r\n```bash\r\npython -m holobit_sdk.transpiler.machine_code_transpiler --input ejemplo.holo --arch x86\r\n```\r\n\r\n## \ud83d\udce6 Despliegue y Distribuci\u00f3n\r\nEl SDK Holobit ser\u00e1 empaquetado y distribuido a trav\u00e9s de **GitHub Releases** y **PyPI**.\r\n\r\n### \ud83d\udd39 Construcci\u00f3n del Paquete\r\n```bash\r\npython setup.py sdist bdist_wheel\r\n```\r\n\r\n### \ud83d\udd39 Publicaci\u00f3n en PyPI\r\n```bash\r\npip install twine\r\n\r\n# Subir el paquete\r\npython -m twine upload dist/*\r\n```\r\n\r\n## \ud83e\uddea Pruebas\r\nPara ejecutar las pruebas unitarias del proyecto debes instalar las dependencias opcionales.\r\nLa suite completa requiere la librer\u00eda `qiskit`, incluida en este archivo, para ejecutar las pruebas de integraci\u00f3n cu\u00e1ntica:\r\n```bash\r\npip install -r requirements_optional.txt\r\n```\r\nSi adem\u00e1s deseas comprobar la cobertura de c\u00f3digo instala las dependencias de desarrollo y ejecuta `coverage`:\r\n```bash\r\npip install -r requirements_dev.txt\r\n```\r\nLuego ejecuta `flake8` para verificar el estilo y `coverage run` junto con `pytest`:\r\n```bash\r\nflake8\r\ncoverage run -m pytest\r\n```\r\nEste repositorio cuenta con un flujo de **Integraci\u00f3n Continua** en GitHub Actions que instala estas dependencias y ejecuta las pruebas en cada *push* y *pull request*.\r\n\r\n## \ud83d\udee0 Mantenimiento y Contribuci\u00f3n\r\nSi deseas contribuir al SDK Holobit, puedes hacer un **fork** del repositorio y enviar un **pull request** con tus mejoras.\r\n\r\n## \ud83d\udce7 Contacto y Soporte\r\nPara cualquier consulta, reportes de errores o contribuciones, puedes contactarnos en **adolfogonzal@gmail.com** o a trav\u00e9s del repositorio en **GitHub**.\r\n\r\n---\r\n\r\n\ud83d\udccc **Holobit SDK - Computaci\u00f3n Cu\u00e1ntica Hologr\u00e1fica para el Futuro** \ud83d\ude80\r\n\r\n\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "SDK para arquitectura hologr\u00e1fica avanzada",
"version": "1.0.8",
"project_urls": {
"Homepage": "https://github.com/Alphonsus411/holobit_SDK"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "0e46c6a040e59bfe53d7e0fdd97aebb8859475a9ca1e45def25d1a83288ffc00",
"md5": "aafef1fb7be92314fad1a5b54e1bde66",
"sha256": "b1de34f4744b3c1eec6f91418cd41ec615b31e61bdd857ea63f6b9f2f8599b32"
},
"downloads": -1,
"filename": "holobit_sdk-1.0.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "aafef1fb7be92314fad1a5b54e1bde66",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 46507,
"upload_time": "2025-07-24T17:26:41",
"upload_time_iso_8601": "2025-07-24T17:26:41.562674Z",
"url": "https://files.pythonhosted.org/packages/0e/46/c6a040e59bfe53d7e0fdd97aebb8859475a9ca1e45def25d1a83288ffc00/holobit_sdk-1.0.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "16b6911429d270446baf0ca2e1da4213d2261928e57f69c35c28e39dfd6d1b37",
"md5": "0aff28d41201cf6a2593340701e606be",
"sha256": "b73f80b0574e6ccfa6a2bf4a08fe228ad27f2bcd3be0ebf4f2952a7eaac4d545"
},
"downloads": -1,
"filename": "holobit_sdk-1.0.8.tar.gz",
"has_sig": false,
"md5_digest": "0aff28d41201cf6a2593340701e606be",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 32817,
"upload_time": "2025-07-24T17:26:43",
"upload_time_iso_8601": "2025-07-24T17:26:43.426537Z",
"url": "https://files.pythonhosted.org/packages/16/b6/911429d270446baf0ca2e1da4213d2261928e57f69c35c28e39dfd6d1b37/holobit_sdk-1.0.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-24 17:26:43",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Alphonsus411",
"github_project": "holobit_SDK",
"github_not_found": true,
"lcname": "holobit-sdk"
}
JSON
