{"id":20978051,"url":"https://github.com/isaac-sim/isaaclabextensiontemplate","last_synced_at":"2025-04-12T23:34:27.551Z","repository":{"id":230286078,"uuid":"749853277","full_name":"isaac-sim/IsaacLabExtensionTemplate","owner":"isaac-sim","description":"External extenstion template based on Isaac Lab","archived":false,"fork":false,"pushed_at":"2025-03-07T17:58:53.000Z","size":84,"stargazers_count":178,"open_issues_count":8,"forks_count":62,"subscribers_count":14,"default_branch":"main","last_synced_at":"2025-03-28T04:15:46.638Z","etag":null,"topics":["isaac-sim","omniverse","orbit","template-project"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/isaac-sim.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-01-29T14:28:56.000Z","updated_at":"2025-03-24T16:39:36.000Z","dependencies_parsed_at":"2024-03-28T21:53:22.214Z","dependency_job_id":"fc88578b-9791-4954-802b-9a5c31cc784f","html_url":"https://github.com/isaac-sim/IsaacLabExtensionTemplate","commit_stats":{"total_commits":33,"total_committers":8,"mean_commits":4.125,"dds":0.5151515151515151,"last_synced_commit":"5334b2ebac03cd8b1eb2f80bea725a06a6ad97e9"},"previous_names":["isaac-orbit/orbit.ext_template"],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/isaac-sim%2FIsaacLabExtensionTemplate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/isaac-sim%2FIsaacLabExtensionTemplate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/isaac-sim%2FIsaacLabExtensionTemplate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/isaac-sim%2FIsaacLabExtensionTemplate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/isaac-sim","download_url":"https://codeload.github.com/isaac-sim/IsaacLabExtensionTemplate/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247123095,"owners_count":20887261,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["isaac-sim","omniverse","orbit","template-project"],"created_at":"2024-11-19T05:04:07.841Z","updated_at":"2025-04-04T05:01:51.754Z","avatar_url":"https://github.com/isaac-sim.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Template for Isaac Lab Projects\n\n[![IsaacSim](https://img.shields.io/badge/IsaacSim-4.5.0-silver.svg)](https://docs.omniverse.nvidia.com/isaacsim/latest/overview.html)\n[![Isaac Lab](https://img.shields.io/badge/IsaacLab-2.0.0-silver)](https://isaac-sim.github.io/IsaacLab)\n[![Python](https://img.shields.io/badge/python-3.10-blue.svg)](https://docs.python.org/3/whatsnew/3.10.html)\n[![Linux platform](https://img.shields.io/badge/platform-linux--64-orange.svg)](https://releases.ubuntu.com/20.04/)\n[![Windows platform](https://img.shields.io/badge/platform-windows--64-orange.svg)](https://www.microsoft.com/en-us/)\n[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit\u0026logoColor=white)](https://pre-commit.com/)\n[![License](https://img.shields.io/badge/license-MIT-yellow.svg)](https://opensource.org/license/mit)\n\n## Overview\n\nThis repository serves as a template for building projects or extensions based on Isaac Lab. It allows you to develop in an isolated environment, outside of the core Isaac Lab repository.\n\n**Key Features:**\n\n- `Isolation` Work outside the core Isaac Lab repository, ensuring that your development efforts remain self-contained.\n- `Flexibility` This template is set up to allow your code to be run as an extension in Omniverse.\n\n**Keywords:** extension, template, isaaclab\n\n## Installation\n\n- Install Isaac Lab by following the [installation guide](https://isaac-sim.github.io/IsaacLab/main/source/setup/installation/index.html). We recommend using the conda installation as it simplifies calling Python scripts from the terminal.\n\n- Clone this repository separately from the Isaac Lab installation (i.e. outside the `IsaacLab` directory):\n\n```bash\n# Option 1: HTTPS\ngit clone https://github.com/isaac-sim/IsaacLabExtensionTemplate.git\n\n# Option 2: SSH\ngit clone git@github.com:isaac-sim/IsaacLabExtensionTemplate.git\n```\n\n- Throughout the repository, the name `ext_template` only serves as an example and we provide a script to rename all the references to it automatically:\n\n```bash\n# Enter the repository\ncd IsaacLabExtensionTemplate\n# Rename all occurrences of ext_template (in files/directories) to your_fancy_extension_name\npython scripts/rename_template.py your_fancy_extension_name\n```\n\n- Using a python interpreter that has Isaac Lab installed, install the library\n\n```bash\npython -m pip install -e source/ext_template\n```\n\n- Verify that the extension is correctly installed by running the following command:\n\n```bash\npython scripts/rsl_rl/train.py --task=Template-Isaac-Velocity-Rough-Anymal-D-v0\n```\n\n### Set up IDE (Optional)\n\nTo setup the IDE, please follow these instructions:\n\n- Run VSCode Tasks, by pressing `Ctrl+Shift+P`, selecting `Tasks: Run Task` and running the `setup_python_env` in the drop down menu. When running this task, you will be prompted to add the absolute path to your Isaac Sim installation.\n\nIf everything executes correctly, it should create a file .python.env in the `.vscode` directory. The file contains the python paths to all the extensions provided by Isaac Sim and Omniverse. This helps in indexing all the python modules for intelligent suggestions while writing code.\n\n### Setup as Omniverse Extension (Optional)\n\nWe provide an example UI extension that will load upon enabling your extension defined in `source/ext_template/ext_template/ui_extension_example.py`.\n\nTo enable your extension, follow these steps:\n\n1. **Add the search path of your repository** to the extension manager:\n    - Navigate to the extension manager using `Window` -\u003e `Extensions`.\n    - Click on the **Hamburger Icon** (☰), then go to `Settings`.\n    - In the `Extension Search Paths`, enter the absolute path to `IsaacLabExtensionTemplate/source`\n    - If not already present, in the `Extension Search Paths`, enter the path that leads to Isaac Lab's extension directory directory (`IsaacLab/source`)\n    - Click on the **Hamburger Icon** (☰), then click `Refresh`.\n\n2. **Search and enable your extension**:\n    - Find your extension under the `Third Party` category.\n    - Toggle it to enable your extension.\n\n## Docker setup\n\n### Building Isaac Lab Base Image\n\nCurrently, we don't have the Docker for Isaac Lab publicly available. Hence, you'd need to build the docker image\nfor Isaac Lab locally by following the steps [here](https://isaac-sim.github.io/IsaacLab/main/source/deployment/index.html).\n\nOnce you have built the base Isaac Lab image, you can check it exists by doing:\n\n```bash\ndocker images\n\n# Output should look something like:\n#\n# REPOSITORY                       TAG       IMAGE ID       CREATED          SIZE\n# isaac-lab-base                   latest    28be62af627e   32 minutes ago   18.9GB\n```\n\n### Building Isaac Lab Template Image\n\nFollowing above, you can build the docker container for this project. It is called `isaac-lab-template`. However,\nyou can modify this name inside the [`docker/docker-compose.yaml`](docker/docker-compose.yaml).\n\n```bash\ncd docker\ndocker compose --env-file .env.base --file docker-compose.yaml build isaac-lab-template\n```\n\nYou can verify the image is built successfully using the same command as earlier:\n\n```bash\ndocker images\n\n# Output should look something like:\n#\n# REPOSITORY                       TAG       IMAGE ID       CREATED             SIZE\n# isaac-lab-template               latest    00b00b647e1b   2 minutes ago       18.9GB\n# isaac-lab-base                   latest    892938acb55c   About an hour ago   18.9GB\n```\n\n### Running the container\n\nAfter building, the usual next step is to start the containers associated with your services. You can do this with:\n\n```bash\ndocker compose --env-file .env.base --file docker-compose.yaml up\n```\n\nThis will start the services defined in your `docker-compose.yaml` file, including isaac-lab-template.\n\nIf you want to run it in detached mode (in the background), use:\n\n```bash\ndocker compose --env-file .env.base --file docker-compose.yaml up -d\n```\n\n### Interacting with a running container\n\nIf you want to run commands inside the running container, you can use the `exec` command:\n\n```bash\ndocker exec --interactive --tty -e DISPLAY=${DISPLAY} isaac-lab-template /bin/bash\n```\n\n### Shutting down the container\n\nWhen you are done or want to stop the running containers, you can bring down the services:\n\n```bash\ndocker compose --env-file .env.base --file docker-compose.yaml down\n```\n\nThis stops and removes the containers, but keeps the images.\n\n## Code formatting\n\nWe have a pre-commit template to automatically format your code.\nTo install pre-commit:\n\n```bash\npip install pre-commit\n```\n\nThen you can run pre-commit with:\n\n```bash\npre-commit run --all-files\n```\n\n## Troubleshooting\n\n### Pylance Missing Indexing of Extensions\n\nIn some VsCode versions, the indexing of part of the extensions is missing. In this case, add the path to your extension in `.vscode/settings.json` under the key `\"python.analysis.extraPaths\"`.\n\n```json\n{\n    \"python.analysis.extraPaths\": [\n        \"\u003cpath-to-ext-repo\u003e/source/ext_template\"\n    ]\n}\n```\n\n### Pylance Crash\n\nIf you encounter a crash in `pylance`, it is probable that too many files are indexed and you run out of memory.\nA possible solution is to exclude some of omniverse packages that are not used in your project.\nTo do so, modify `.vscode/settings.json` and comment out packages under the key `\"python.analysis.extraPaths\"`\nSome examples of packages that can likely be excluded are:\n\n```json\n\"\u003cpath-to-isaac-sim\u003e/extscache/omni.anim.*\"         // Animation packages\n\"\u003cpath-to-isaac-sim\u003e/extscache/omni.kit.*\"          // Kit UI tools\n\"\u003cpath-to-isaac-sim\u003e/extscache/omni.graph.*\"        // Graph UI tools\n\"\u003cpath-to-isaac-sim\u003e/extscache/omni.services.*\"     // Services tools\n...\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fisaac-sim%2Fisaaclabextensiontemplate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fisaac-sim%2Fisaaclabextensiontemplate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fisaac-sim%2Fisaaclabextensiontemplate/lists"}