Regennexus

🚀 RegenNexus UAP

通用適配器協議 - 以極低的延遲和極高的安全性連接設備、機器人、應用程序和 AI 代理。與 MCP 兼容，可實現無縫的 AI 集成。

🚀 快速開始

以下是一個簡單的 Python 代碼示例，展示瞭如何使用 RegenNexusProtocol：

import asyncio
from regennexus import RegenNexusProtocol

async def main():
    protocol = RegenNexusProtocol()
    await protocol.initialize()

    # Register entities
    await protocol.registry.register_entity(
        entity_id="sensor_01",
        entity_type="device",
        capabilities=["temperature", "humidity"]
    )

    # Send messages
    await protocol.send_message(
        sender="controller",
        recipient="sensor_01",
        intent="read",
        payload={"sensors": ["temperature"]}
    )

    await protocol.shutdown()

asyncio.run(main())

✨ 主要特性

設備支持

• 樹莓派（Raspberry Pi） - GPIO、PWM、攝像頭、傳感器
• Arduino - 數字/模擬輸入輸出、串口命令
• NVIDIA Jetson - GPU、CUDA、攝像頭、推理
• 物聯網設備（IoT Devices） - MQTT、HTTP、CoAP 協議

機械臂支持

• Amber B1 - 7 自由度控制、夾爪、軌跡規劃
• Lucid One - 笛卡爾座標控制、力傳感、示教模式

from regennexus.plugins import get_amber_b1_plugin

AmberB1 = get_amber_b1_plugin()
arm = AmberB1(entity_id="arm_001", mock_mode=True)
await arm.initialize()

# Move joints
await arm.move_to([0, 45, -30, 0, 90, 0, 0], duration=2.0)

# Gripper control
await arm.open_gripper()
await arm.close_gripper(force=15.0)

傳輸層

安全性

• 加密：AES - 128/256 - GCM
• 密鑰交換：ECDH - 384
• 認證：令牌、API 密鑰
• 速率限制：自適應限流

AI 集成（MCP）

可直接從 Claude Desktop 或任何與 MCP 兼容的 AI 控制硬件：

# 啟動用於 Claude Desktop 的 MCP 服務器
python -m regennexus.mcp_server

在 claude_desktop_config.json 中進行配置：

{
    "mcpServers": {
        "regennexus": {
            "command": "python",
            "args": ["-m", "regennexus.mcp_server"]
        }
    }
}

現在可以向 Claude 提問：

• "將機械臂移動到拾取位置"
• "打開 GPIO 引腳 17"
• "溫度傳感器的讀數是多少？"

大語言模型橋接（Ollama、LM Studio）

將本地大語言模型連接到硬件：

from regennexus.bridges import LLMBridge, LLMConfig

llm = LLMBridge(LLMConfig(provider="ollama", model="llama3"))
response = await llm.chat("打開燈光")

網狀網絡

在網絡中的設備間實現自動發現：

from regennexus.core import MeshNetwork, MeshConfig

mesh = MeshNetwork(MeshConfig(
    node_id="controller",
    capabilities=["command"]
))
await mesh.start()

# 設備自動發現
for peer in mesh.get_peers():
    print(f"發現: {peer.node_id} ({peer.capabilities})")

💻 使用示例

基礎用法

import asyncio
from regennexus import RegenNexusProtocol

async def main():
    protocol = RegenNexusProtocol()
    await protocol.initialize()

    # Register entities
    await protocol.registry.register_entity(
        entity_id="sensor_01",
        entity_type="device",
        capabilities=["temperature", "humidity"]
    )

    # Send messages
    await protocol.send_message(
        sender="controller",
        recipient="sensor_01",
        intent="read",
        payload={"sensors": ["temperature"]}
    )

    await protocol.shutdown()

asyncio.run(main())

高級用法

from regennexus.plugins import get_amber_b1_plugin

AmberB1 = get_amber_b1_plugin()
arm = AmberB1(entity_id="arm_001", mock_mode=True)
await arm.initialize()

# Move joints
await arm.move_to([0, 45, -30, 0, 90, 0, 0], duration=2.0)

# Gripper control
await arm.open_gripper()
await arm.close_gripper(force=15.0)

📦 安裝指南

pip install regennexus

或者安裝包含所有功能的版本：

pip install regennexus[full]

📚 詳細文檔

• 入門指南
• MCP 集成
• 設備集成
• 機械臂指南
• 安全指南
• API 參考
• ROS 集成

交互式演示

可以在 Google Colab 中嘗試 RegenNexus：

• 基礎演示 - 核心通信
• 安全演示 - 加密與認證

CLI 使用方法

# 啟動服務器
regen server --host 0.0.0.0 --port 8080

# 運行示例
regen run examples/robotic_arms/arm_demo.py

# 查看版本信息
regen version

可選依賴

pip install regennexus[api]        # FastAPI 服務器
pip install regennexus[mqtt]       # MQTT 支持
pip install regennexus[robotics]   # 機械臂支持
pip install regennexus[arduino]    # Arduino 支持
pip install regennexus[dev]        # 開發工具

示例代碼結構

examples/
├── simple_connection/    # 基本協議使用
├── mcp_integration/      # Claude Desktop 與大語言模型演示
├── mesh_network/         # 設備自動發現
├── llm_integration/      # Ollama/LM Studio 演示
├── robotic_arms/         # Amber B1 與 Lucid One 演示
├── ros_integration/      # ROS 2 橋接示例
├── security/             # 加密與認證
└── binder/               # Jupyter 筆記本

Docker 部署

docker-compose up

詳情請參閱 Docker 部署。

貢獻代碼

我們歡迎貢獻！請參閱 CONTRIBUTING.md 瞭解貢獻指南。

📄 許可證

本項目採用 MIT 許可證 - 詳情請參閱 LICENSE。

RegenNexus UAP - 安全地連接一切。

版權所有 (c) 2024 - 2025 ReGen Designs LLC