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.
No packaged installer is documented yet

The current public path is to build from the repository. Follow GitHub for packaging and release changes rather than relying on Docker or installation instructions from earlier OpenCaddis versions.

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