Skip to content

Installation

Tagua needs .NET 10 or later.

  1. Add the package to your project:

    Terminal window
    dotnet add package Tagua
  2. Declare the license you use Tagua under, once, at startup:

    TaguaSettings.License = LicenseType.Community;

    Community is free for companies with fewer than 100 people and less than USD 1 million in revenue, and for noncommercial use; Trial is free for evaluating Tagua for less than 32 days. Otherwise use Professional or Enterprise. You can also set the environment variable TAGUA_LICENSE instead. See Licensing.

  3. If your documents have Arabic, Hebrew, Hindi or other scripts whose letters join or reorder, add the HarfBuzz shaper too:

    Terminal window
    dotnet add package Tagua.Shaping.HarfBuzz

    It brings HarfBuzz’s native libraries for Windows, macOS and Linux. Right-to-left text, font fallback and line breaking work without it.

The tagua command renders templates to PDF, renders them again whenever you save (preview as you edit), converts RDLC reports, and prints the template JSON Schema for your editor. Install it as a .NET tool:

Terminal window
dotnet tool install --global Tagua.Cli
tagua --version

Next: your first report.