Home / Docs / Build from source

Build from source

Build the current repository

OpenCaddis is currently a source-first project. The repository contains the Windows app, local Server, Server Builder, and test project in one .NET 10 solution.

Prerequisites

  • Windows 10 version 1809 or newer
  • .NET 10 SDK
  • A current Visual Studio installation with the .NET MAUI workload for running the desktop app
  • Git
  • A compatible model-provider API key for first run

Clone and verify

PowerShell
git clone https://github.com/vulcan365/OpenCaddis.git
cd OpenCaddis
dotnet build src/OpenCaddis.slnx
dotnet test src/OpenCaddis.Server.Tests/OpenCaddis.Server.Tests.csproj

Run the app

  1. Open src/OpenCaddis.slnx in Visual Studio.
  2. Select OpenCaddis.App as the startup project and the Windows Machine target.
  3. Start the application.
  4. Open Server → Cloud configuration and save a model/API-key document for the mode you want to run.
  5. Choose Server or Server Builder, confirm the local port and add-on path, then select Start.
Prefer the Windows installer?

Most users can install the self-contained Windows build with one PowerShell command. See the installation guide. Build from source when contributing or debugging the product itself.

Repository layout

PathContents
src/OpenCaddis.AppWindows .NET MAUI application and local orchestration.
src/OpenCaddis.ServerFabrCore Host, Surface integration, configuration service, and add-on loading.
src/OpenCaddis.Server.BuilderWorkspace service, Harness builder agent, embedded Agent Skill packages, Roslyn inspection, scoped filesystem, and .NET CLI tools.
src/OpenCaddis.Server.TestsHost, cloud configuration, agent registry, managed Skills, workspace, add-on loading, and Builder tests.

Project links

RepositoryIssuesFabrCore docs
Documentation