# System Requirements

## Browser

| Requirement             | Details                                            |
| ----------------------- | -------------------------------------------------- |
| **Supported Browsers**  | Google Chrome (recommended), Edge, Mozilla Firefox |
| **Not Supported**       | Internet Explorer, Safari                          |
| **Minimum RAM**         | 12 GB                                              |
| **Required Technology** | WebGL enabled                                      |

{% hint style="success" %}
**Recommended:** Google Chrome offers the best performance due to its faster Chromium V8 engine. Our default test environment is Chrome.
{% endhint %}

**Useful Links:**

* [Download Google Chrome](https://www.google.com/chrome/)
* [Test WebGL Support](https://get.webgl.org/)

***

## OpenBrIM Launcher

Chrome throttles background tabs to save resources, which can significantly slow down analysis and result extraction when minimized.

The OpenBrIM Launcher configures Chrome for optimal performance:

| Feature             | Benefit                                                |
| ------------------- | ------------------------------------------------------ |
| Background analysis | Runs at full speed when minimized                      |
| Result extraction   | \~50% speed when minimized (vs. near-zero without)     |
| Isolated profile    | Keeps OpenBrIM sessions separate from regular browsing |

**Download:** Copy the script below and save it as `OpenBrIM-Launcher.bat`:

```batch
@echo off
setlocal enabledelayedexpansion
title OpenBrIM Launcher

set "CONFIG=%USERPROFILE%\.openbrim_config"

if exist "%CONFIG%" (
    set /p COMPANY=<"%CONFIG%"
    echo.
    echo Using saved company: !COMPANY!
    echo Opening https://!COMPANY!.openbrim.org
    echo.
    set /p "CHOICE=Press Enter to continue or type 'change' to update: "
    if /i "!CHOICE!"=="change" goto :ask
    goto :launch
)

:ask
echo.
echo Your OpenBrIM URL looks like: https://yourcompany.openbrim.org
set /p "INPUT=Enter your company name only (e.g., wsp, kiewit, atkins, jacobs): "

if "!INPUT!"=="" (
    echo No company name entered. Exiting.
    pause
    exit /b
)

:: Remove https:// if present
set "COMPANY=!INPUT:https://=!"
:: Remove http:// if present
set "COMPANY=!COMPANY:http://=!"
:: Remove .openbrim.org if present
set "COMPANY=!COMPANY:.openbrim.org=!"
:: Remove trailing slash if present
set "COMPANY=!COMPANY:/=!"

echo !COMPANY!>"%CONFIG%"
echo Company name saved: !COMPANY!

:launch
start "" "C:\Program Files\Google\Chrome\Application\chrome.exe" ^
    --disable-background-timer-throttling ^
    --disable-renderer-backgrounding ^
    --disable-background-tab-freezing ^
    --disable-backgrounding-occluded-windows ^
    --disable-hang-monitor ^
    --disable-ipc-flooding-protection ^
    --disable-gpu-vsync ^
    --disable-features=CalculateNativeWinOcclusion,TabFreeze,TabGroupsCollapseFreezing,BackForwardCache,BackgroundMediaSuspend,IntensiveWakeUpThrottling ^
    --user-data-dir="C:\ChromeProfiles\OpenBrIMSession" ^
    --profile-directory=Default ^
    --new-window "https://!COMPANY!.openbrim.org/"
```

{% hint style="info" %}
**Note:** The script assumes Chrome is installed at `C:\Program Files\Google\Chrome\Application\chrome.exe`. If Chrome is installed elsewhere, update the path in the script. To find your Chrome path, type `chrome://version` in Chrome's address bar and look for "Executable Path".
{% endhint %}

No installation or admin privileges required. On first run, enter your company name (e.g., `companyname` for `companyname.openbrim.org`). The launcher saves your preference for future use.

***

## Enhancing Platform Performance

Laptops and browsers often conserve battery by limiting hardware utilization. Adjust these settings for optimal performance.

### Use Discrete GPU

**Step 1:** Check which GPU Chrome is using. Open `chrome://gpu/` and find "GL Renderer".

<figure><img src="https://openbrim.atlassian.net/wiki/download/attachments/2326757379/image-20241104-113810.png?api=v2" alt="Chrome GPU info showing Intel graphics"><figcaption><p>Default: Chrome using integrated Intel graphics</p></figcaption></figure>

**Step 2:** Open NVIDIA Control Panel (search "Nvidia" in Windows). Select Chrome or Edge and assign "High Performance Nvidia Processor".

<figure><img src="https://openbrim.atlassian.net/wiki/download/attachments/2326757379/image-20231219-200149.png?api=v2" alt="NVIDIA Control Panel settings"><figcaption><p>NVIDIA Control Panel GPU assignment</p></figcaption></figure>

**Step 3 (Alternative):** Search "Graphics Settings" in Windows, select "Desktop App", browse to your browser's .exe file, click "Options", and set your preferred GPU.

<figure><img src="https://openbrim.atlassian.net/wiki/download/attachments/2326757379/image-20231219-200156.png?api=v2" alt="Windows Graphics Settings"><figcaption><p>Windows Graphics Settings</p></figcaption></figure>

**Step 4:** Verify by reopening `chrome://gpu/`. Intel should no longer appear under "GL Renderer".

<figure><img src="https://openbrim.atlassian.net/wiki/download/attachments/2326757379/image-20241104-113014.png?api=v2" alt="Chrome GPU info showing NVIDIA"><figcaption><p>Success: Chrome now using discrete NVIDIA GPU</p></figcaption></figure>

***

### Disable Browser Efficiency Mode

{% tabs %}
{% tab title="Chrome" %}
Go to **Settings > Performance** and disable memory and energy saver features.

<figure><img src="https://openbrim.atlassian.net/wiki/download/attachments/2326757379/image-20231219-195731.png?api=v2" alt="Chrome performance settings"><figcaption><p>Chrome Settings > Performance</p></figcaption></figure>

<figure><img src="https://openbrim.atlassian.net/wiki/download/attachments/2326757379/image-20231219-200412.png?api=v2" alt="Chrome energy saver disabled"><figcaption><p>Disable energy saver</p></figcaption></figure>
{% endtab %}

{% tab title="Edge" %}
Disable these features in Edge settings:

* Efficiency Mode
* Improve Your PC Gaming
* Sleeping Tabs

<figure><img src="https://openbrim.atlassian.net/wiki/download/attachments/2326757379/image-20231219-193608.png?api=v2" alt="Edge efficiency settings"><figcaption><p>Edge efficiency settings</p></figcaption></figure>

<figure><img src="https://openbrim.atlassian.net/wiki/download/attachments/2326757379/image-20231219-195013.png?api=v2" alt="Edge sleeping tabs"><figcaption><p>Disable sleeping tabs</p></figcaption></figure>
{% endtab %}
{% endtabs %}

***

### Windows Power Settings

Click the battery icon on the taskbar and set the slider to maximum performance.

<figure><img src="https://openbrim.atlassian.net/wiki/download/attachments/2326757379/image-20231219-200652.png?api=v2" alt="Windows power slider"><figcaption><p>Set power mode to Best Performance</p></figcaption></figure>

***

### OpenBrIM Performance Settings

**Control Compilation Scope**

Reduce compilation time by toggling FEM or Detailing on/off. See [Pause / FEM / Detailing Bar](https://github.com/openbrim/platform/blob/master/docs/library/getting-started/navigation-within-openbrimapp/projects/project-ui/pause-fem-detailing-bar.md).

**Simplify Rendered Elements**

Deactivate rendering of bolts or shear studs if they significantly impact compilation time.

<figure><img src="https://openbrim.atlassian.net/wiki/download/attachments/2326757379/image-20231219-201310.png?api=v2" alt="Bolt rendering settings"><figcaption><p>Toggle bolt/stud rendering in the spreadsheet</p></figcaption></figure>

**Performance Profiling**

Identify which objects impact compilation time by appending `&perf=1` to your project URL.

<figure><img src="https://openbrim.atlassian.net/wiki/download/attachments/2326757379/image-20231219-201545.png?api=v2" alt="URL with perf parameter"><figcaption><p>Add &#x26;perf=1 to the URL</p></figcaption></figure>

After compilation, access the performance report from the settings menu:

<figure><img src="https://openbrim.atlassian.net/wiki/download/attachments/2326757379/image-20231219-201654.png?api=v2" alt="Settings menu"><figcaption><p>Open settings menu</p></figcaption></figure>

<figure><img src="https://openbrim.atlassian.net/wiki/download/attachments/2326757379/image-20231219-201821.png?api=v2" alt="Performance report option"><figcaption><p>Select performance report</p></figcaption></figure>

<figure><img src="https://openbrim.atlassian.net/wiki/download/attachments/2326757379/image-20231219-201831.png?api=v2" alt="Performance report results"><figcaption><p>Review compilation times by operation</p></figcaption></figure>


---

# 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.openbrim.org/openbrim/getting-started/system-requirements.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.