كيفية إعداد OpenVLA: دليل عملي

# تثبيت OpenVLA والمتطلبات
pip install openvla torch==2.2.0 torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121
pip install transformers==4.40.0 datasets==2.18.0 ros2cli  # ROS 2 Humble مطلوب للروبوتات

from huggingface_hub import snapshot_download

# تنزيل إلى ~/.cache/huggingface/hub/openvla/openvla-7b
snapshot_download(
    repo_id="openvla/openvla-7b",
    local_dir="openvla-7b",
    local_dir_use_symlinks=False  # تجنب مشاكل الروابط الرمزية على بعض أنظمة الملفات
)

git clone https://github.com/openvla/openvla-demos.git
cd openvla-demos/isaac_sim

# بدء Isaac Sim مع ديمو OpenVLA
./launch_isaac_sim.sh

from openvla import OpenVLA
from openvla_demos.utils import capture_frame

# تهيئة النموذج (يحمّل من الدليل المخفي)
model = OpenVLA.from_pretrained("openvla-7b")

# التقاط إطار من Isaac Sim
image = capture_frame("isaac_sim_camera")  # يفترض موضوع ROS 2 /isaac_sim_camera/image_raw

# توليد عمل
prompt = "أمسك الأسطوانة الحمراء وأضعها على الطاولة الرمادية."
actions = model.generate(
    image=image,
    prompt=prompt,
    num_actions=20,  # التنبؤ بـ20 خطوة مقدما
    temperature=0.3  # أقل = أكثر تحديدا
)

print(f"الأعمال المتنبأ بها: {actions.shape}")  # يجب أن يظهر torch.Size([20, 7])

الأعمال المتنبأ بها: torch.Size([20, 7])

model = OpenVLA.from_pretrained("openvla-7b", torch_dtype=torch.float16)

# شكل العمل: (T, 7) حيث T = الأفق (مثل 20)
actions = torch.tensor([
    [0.1, -0.2, 0.0, 0.3, -0.1, 0.0, 0.0],  # خطوة زمنية 0
    [0.05, -0.1, 0.0, 0.2, -0.05, 0.0, 0.0]  # خطوة زمنية 1
])

from openvla_ros import OpenVLAROSNode

node = OpenVLAROSNode(
    robot_name="franka_panda",
    action_topic="/franka_panda/joint_actions"
)
node.publish_actions(actions)  # يرسل إلى ROS 2

actions = actions * 0.5  # UR5 لديها حدود مفصل أكثر صرامة من Franka

{
    "images": [np.array],  # (T, H, W, 3)
    "prompts": ["str"],    # قائمة الأوامر اللغوية
    "actions": [np.array], # (T, 7) التغيرات في زوايا المفاصل
    "success": [bool]      # علامة نجاح المهمة ثنائية
}

your_data/
├── images/
│   ├── task1/
│   │   ├── frame_001.png
│   │   └── ...
│   └── task2/
├── metadata.json  # JSON مع الأوامر، الأعمال، علامات النجاح

from openvla import OpenVLA
from openvla.finetune import LoRATrainer

# تحميل النموذج الأساسي
model = OpenVLA.from_pretrained("openvla-7b")

# تهيئة محسن LoRA
trainer = LoRATrainer(
    model=model,
    dataset_path="your_data/metadata.json",
    output_dir="openvla-finetuned",
    per_device_train_batch_size=4,  # قلل إذا حدث خطأ خارج الذاكرة
    num_train_epochs=5,
    lr=1e-4,
    lora_r=8,  # رتبة LoRA
    lora_alpha=32
)

# التدريب
trainer.train()

from openvla import OpenVLA
import time

model = OpenVLA.from_pretrained(
    "openvla/openvla-7b",
    torch_dtype=torch.float8_e4m3fn  # INT4
)

start = time.time()
for _ in range(10):
    _ = model.generate(image=test_image, prompt="أمسك الكتل.")
latency = (time.time() - start) / 10  # متوسط لكل استدلال
print(f"التأخر: {latency:.3f}s")  # الهدف: أقل من 20 مللي ثانية

التأخر: 0.018s  # 18 مللي ثانية لكل استدلال

# تثبيت TensorRT
pip install nvidia-pyindex nvidia-tensorrt

# كمية وتجميع
from openvla.tensorrt import compile_model

compiled_model = compile_model(
    model=model,
    max_batch_size=1,
    workspace_size=1 << 25  # 32MB
)

sudo apt update && sudo apt install -y cuda-toolkit-12-1

from openvla_safety import SafetyWrapper

# تعريف قيود الأمان
constraints = {
    "joint_limits": {
        "min": [-2.897, -1.767, -2.897, -3.054, -2.897, -0.017, -2.897],  # Franka Panda
        "max": [2.897, 1.767, 2.897, -0.069, 2.897, 3.740, 2.897]
    },
    "velocity_limit": 0.5,  # راديان/ثانية
    "collision_margin": 0.05  # متر
}

# وضع النموذج في طبقة الأمان
safe_model = SafetyWrapper(
    model=model,
    constraints=constraints,
    fallback_action="stop"  # العمل البديل إذا تم انتهاك القيود
)

# اختبار
actions = safe_model.generate(image, prompt)
print(f"الأعمال الآمنة: {actions}")

الأعمال الآمنة: torch.Size([20, 7])