Skip to content

Getting Started

Jump to bottom
SiliconeShojo edited this page Apr 30, 2026 · 1 revision

Getting Started with TagForge

Welcome! This guide will help you get TagForge up and running on your system.

📥 Installation

TagForge is distributed as a portable, standalone executable. There is no installer wizard—simply download and run.

1. Download

Visit the Releases Page and download the version for your operating system:

  • Windows: TagForge-win-x64.exe
  • Linux: TagForge-linux-x64
  • macOS: TagForge-osx-arm64 (Apple Silicon) or TagForge-osx-x64 (Intel)

2. Run

  1. Windows: Double-click TagForge-win-x64.exe.
  2. Linux/macOS: Run the executable from terminal (e.g., ./TagForge-linux-x64).

Caution

Windows SmartScreen: Since TagForge is a new open-source tool, you might get a "Windows protected your PC" popup. Click More info -> Run anyway.

[!NOTE] First Launch Performance: TagForge is a pre-compiled high-performance binary. The very first time you run it after a download, your operating system may perform a security scan. This may cause a 2-3 second delay. Subsequent launches will be near-instant.

Tip

Linux/macOS Users: You may need to grant execution permissions:

chmod +x TagForge

📂 Data & Configuration

TagForge stores all settings, API keys, and history in a unified location in your user profile:

  • Path: ~/.tagforge/ (e.g., C:\Users\YourName\.tagforge on Windows)
  • Security: All API keys are encrypted with a machine-specific hardware salt.
  • Migration: If you are upgrading from a version older than v2.2, your data will be automatically migrated to this new folder on the first launch.

🛠️ Building from Source

If you prefer to build the application yourself, you will need the .NET 9.0 SDK.

  1. Install SDK: Download from dotnet.microsoft.com.

  2. Clone Repo:

    git clone https://github.com/SiliconeShojo/TagForge.git
cd TagForge

  3. Build: Run the command for your target OS:

    Windows

    dotnet build TagForge.csproj -c Release

    Linux

    dotnet build TagForge.csproj -c Release -r linux-x64

    macOS

    dotnet build TagForge.csproj -c Release -r osx-arm64

⚙️ First Run

When you launch TagForge for the first time:

Connect an Agent

TagForge needs an AI "brain" to work.

  1. Select a provider (e.g., Google Gemini or Ollama).
  2. Enter your API Key.
  3. Click Fetch Models.

Note

See the Agents & Providers guide for detailed connection instructions.

Clone this wiki locally