# Overview

## Clone the Repository

Make sure you clone the RealSim repository first:

```bash
git clone git@github.com:NUS-HcRL/realsim_py.git
```

## Next Steps

After cloning the repository, you can build RealSim in two different ways, depending on your workflow and environment:

### [Build from Source](/installation/build-from-source.md) (Recommended)

This option gives you full control over all dependencies and is suitable for developers who want to modify the engine, experiment with low-level modules, or integrate custom libraries. You will manually install system packages, third-party libraries, and build RealSim with CMake. Choose this method if you need:

* Deep customization
* Development on RealSim internals
* Integration with other native libraries or research code

### [Build with Docker](/installation/build-with-docker.md)

This option provides the fastest setup. All dependencies are preinstalled inside a Docker image. You only need Docker, the NVIDIA container toolkit, and a working GPU driver. This method is ideal if you want:

* A fully reproducible environment
* Minimal system configuration
* The ability to run RealSim immediately inside a GPU-accelerated container


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.realsim-gym.org/installation/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.