Install and first run

Prerequisites, clone, build, test, setup, and launch Vitruvian CLI.

Prerequisites

Install the following first:

• .NET 8 SDK
• Git

Verify your environment:

dotnet --version
git --version

Clone, build, and test

git clone https://github.com/mrrasmussendk/Vitruvian.git
cd Vitruvian
dotnet build Vitruvian.sln
dotnet test Vitruvian.sln

If you only need to test one area:

dotnet test --filter "FullyQualifiedName~GoapPlannerTests"

Guided setup (recommended)

Run the installer script. It writes profile-based environment files and selects your active profile.

Linux / macOS

./scripts/install.sh

Windows PowerShell

.\scripts\install.ps1

Setup asks you to choose:

1. Profile (dev, personal, team, prod)
2. Provider (openai, anthropic, gemini)
3. API key
4. Optional model override
5. Deployment mode (local CLI, Discord, or WebSocket)
6. Memory storage mode

Run Vitruvian

dotnet run --project src/Vitruvian.Cli

Expected prompt:

Vitruvian CLI started. Type a request (or 'quit' to exit):
>

Try:

> What is the weather tomorrow?
> Create a file called notes.txt with content "Hello World"
> Read notes.txt then summarize it

Quick troubleshooting

• dotnet: command not found: install .NET 8 SDK and restart shell.
• NuGet restore fails: verify access to https://api.nuget.org/v3/index.json.
• Wrong profile loaded: confirm .env.Vitruvian points to the expected VITRUVIAN_PROFILE.

Next: read Configuration profiles.