Local Development

Agentwerke is a .NET solution with a React/Vite web UI and Docker-based local stacks.

Prerequisites

• .NET SDK from global.json
• Node.js 20 for the web UI and docs site
• Docker and Docker Compose for local stacks
• PostgreSQL when running without Compose

Build the solution

From the repository root:

dotnet restore Agentwerke.sln
dotnet build Agentwerke.sln
dotnet test Agentwerke.sln --no-build

The main CI path excludes the E2E suite unless the full docker stack is running.

Run the API

dotnet run --project src/Agentwerke.Api/Agentwerke.Api.csproj

The OpenAPI document is served at:

/openapi/v1.json

Run the web UI

cd web
npm ci
npm run dev

The Vite dev server proxies /api to the local API when VITE_API_BASE_URL is not set.

Run the docs site

cd docs.agentwerke.de
npm ci
npm run dev

Build the static docs artifact:

npm run build

Preview the built artifact:

npm run preview

Common local stacks

Stack	Command
Quickstart	docker compose -f docker/docker-compose.quickstart.yml up --build
Development	docker compose -f docker/docker-compose.yml up --build
Manual testing	docker compose -f docker/docker-compose.manual.yml up --build
E2E	docker compose -f docker/docker-compose.e2e.yml up --build

Repository map

Path	Purpose
src/Agentwerke.Api	ASP.NET Core host.
src/Agentwerke.Application	Use cases and orchestration contracts.
src/Agentwerke.Domain	Domain model.
src/Agentwerke.Infrastructure	EF Core, Postgres, outbox, dispatch worker.
src/Agentwerke.Workflows	BPMN validation and workflow engine.
src/Agentwerke.Agents	Agent orchestration, model clients, gateways, prompt assembly.
src/Agentwerke.AgentSecOps	Policy evaluation and governance.
src/Agentwerke.Sandboxes	Sandbox lifecycle providers.
src/Agentwerke.Integrations	GitHub, CI/CD, and external connectors.
src/Agentwerke.Storage	Artifact and blob abstractions.
src/Agentwerke.Observability	Logs, metrics, and tracing.
web	React/Vite web UI.
docs.agentwerke.de	Static documentation site.
docs	Raw design, operation, and reference docs used as source material.

Development safety

• Do not commit local settings or secret files.
• Keep agent/tool permissions narrow when adding workflows.
• Use the mock provider for deterministic tests before using a real model.
• Verify evidence-pack behavior when adding new agent interactions, tools, or policy decisions.
• Run relevant tests before opening a PR.