Getting Started

python3 -m venv .venv
source .venv/bin/activate
pip install --upgrade hardsim

export HARDSIM_API_URL=https://api-sim.hardlightsim.com
export HARDSIM_API_KEY=hls_live_your_service_key

import hardsim as hs

client = hs.HardsimClient.from_env()
robot_asset_id = client.upload_input_asset("./assets/hardsim-smoke.urdf", asset_kind="robot")
scene_asset_id = client.upload_input_asset("./assets/table_scene.usd", asset_kind="scene")

job = client.submit_assets(
    robot_asset_id=robot_asset_id,
    scene_asset_id=scene_asset_id,
    robot_asset_type="urdf",
    num_envs=8,
    steps=128,
)
print(job.job_id, job.status)

# Live stream in terminal (recommended)
client.watch_job(job.job_id, poll_interval_s=2.0, timeout_s=36000)

# Manual check anytime
print(client.status(job.job_id))

result = client.wait(job.job_id, poll_interval_s=2.0, timeout_s=900.0, raise_on_error=False)
paths = client.download(job.job_id, "./outputs")
print(result["status"], paths)