Skip to main content

​
Prerequisites

  • A Hardlight account with simulation entitlement.
  • A service API key from the Hardlight dashboard (hls_live_*).
  • Python 3.10+.

​
1) Install SDK

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

​
2) Configure Credentials

export HARDSIM_API_URL=https://api-sim.hardlightsim.com
export HARDSIM_API_KEY=<your_hls_live_key>

​
3) Submit Job

import hardsim as hs

client = hs.HardsimClient.from_env()
robot_uri = client.upload_input("./assets/hardsim-smoke.urdf")

job = client.submit(
    robot=robot_uri,
    scene="table_top_v0",
    num_envs=8,
    steps=128,
)
print(job.job_id, job.status)
upload_input(...) uses an API presigned upload flow by default, so local users do not need AWS credentials.

​
4) Wait + Download Artifacts

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)

​
5) Validate In Dashboard

  • Open Hardlight dashboard Billing -> History for debit records.
  • Open Hardsim Jobs for job status and artifact links.

​
Next