Installation¶

Requirements¶

.NET 10.0 or later
The WebTools.NET NuGet package

Add the Package¶

dotnet CLIPackageReferencePackage Manager Console

dotnet add package WebTools.NET

<PackageReference Include="WebTools.NET" Version="*" />

Install-Package WebTools.NET

Install Playwright Browsers¶

Browser-based features (content fetching, browser search providers, the navigation agent) drive Chromium through Microsoft Playwright. After adding the package, install the Playwright browser binaries once per machine:

pwsh bin/Debug/net10.0/playwright.ps1 install chromium

pwsh is the executable of PowerShell Core, the cross-platform edition of PowerShell that ships with the .NET SDK tooling and can be installed standalone. On Windows, if you only have the classic Windows PowerShell, run the same script with powershell instead:

powershell bin/Debug/net10.0/playwright.ps1 install chromium

Adjust the path to your build output folder (e.g. bin/Release/net10.0/). The script is provided by the Microsoft.Playwright dependency that WebTools.NET pulls in transitively.

Note

DuckDuckGoSearchProvider and IWebAccessService use plain HTTP and do not require Playwright browsers.

CloakBrowser Engine¶

If you plan to use the CloakBrowser engine (see Browser Engines), sessions are launched through CloakLauncher from the CloakBrowser package. Refer to the CloakBrowser documentation for its browser setup requirements.

Next Step¶

Continue with the Quick Start.