> For the complete documentation index, see [llms.txt](https://docs.siminsights.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.siminsights.com/simgenie/getting-started.md).

# Getting started

Build a 3D simulation from a description, or as a variant of one you already have.

Go to [simgenie.ai](https://simgenie.ai) and sign in with your HyperSkill account.

## Building one from scratch

Describe the simulation you want in the box at the bottom, for example *a 3D simulation where a nursing student takes a patient's blood pressure*, and send it. You can attach a document to give it source material to work from, or dictate the request with the microphone button.

<figure><img src="https://2704613365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxYaaXoZ4YGbVdAnAhdcE%2Fuploads%2Fn3kq4zDCZmVgrE12HZ4A%2Fimage.png?alt=media&#x26;token=336c9f40-da7b-4255-9717-6af1a98ecbb5" alt="" width="563"><figcaption></figcaption></figure>

While it works, the pane on the right fills in. When it finishes, three tabs are there:

* **Preview**: the simulation, playable.
* **Simulation Outline**: a plain-language description of what was built, which you can edit and send back.
* **Code**: the underlying definition, for authors who want to adjust details directly.

Keep chatting to change it: *make the patient more anxious*, *add a step for hand hygiene*. Each reply updates the same simulation rather than starting a new one.

Your past chats stay in the app, where you can rename, share or delete them. Sharing a chat creates a public link.

## Building a variant of a simulation you already have

When a simulation already exists that is close to what you need, ask for a variant of it rather than starting over. Examples are a harder version of the same task, a simulation with a different patient, or a timed version.

SimGenie needs to know which simulation you mean, and it identifies simulations by id. Open the simulation under [**Sims**](https://platform.siminsights.com/simulations) in HyperSkill Platform and take the number from the end of the address:

```
platform.siminsights.com/simulations/123
```

Then ask for what you want, naming that number:

> I want to create a variant of 123 where the patient does not speak English.

The variant is a new simulation. The one you based it on is untouched.

## Where it ends up

What SimGenie builds appears under [**Sims**](https://platform.siminsights.com/simulations) in HyperSkill Platform. From there you can share it, run it with a class, or open it in HyperSkill Studio to keep building by hand. See [Authoring a simulation](/hyperskill-studio-authoring/authoring-a-simulation.md).