Skip to main content
Vitruvian is a modular .NET agent runtime that plans work as dependency-aware steps, executes independent steps in parallel, and protects side-effecting actions with human approval.

Install and first run

Go from zero to a working CLI in minutes.

Configuration profiles

Understand .env.Vitruvian, profiles, and deployment modes.

Architecture

Learn how GOAP planning, execution waves, and memory fit together.

Compound requests

See how Vitruvian decomposes multi-intent prompts.

Module catalog

Review built-in modules and optional modules.

Build plugins

Implement your own IVitruvianModule with safe defaults.

Security model

Apply permissions, HITL approvals, sandboxing, and install controls.

Gotchas guide

Avoid common setup and runtime mistakes.

​
What Vitruvian gives you

  • GOAP planning: GoapPlanner builds an ExecutionPlan with explicit dependencies.
  • Parallel execution: PlanExecutor runs independent steps concurrently.
  • Human-in-the-loop controls: write, delete, network, and command execution paths can require approval.
  • Memory and caching: repeated module + input pairs can reuse cached results.
  • Composable modules: use built-in modules or load plugin DLLs.
  • Governance and policy: score proposals with cost/risk constraints and enforce rule-based safeguards.

​
End-to-end request lifecycle

User request
  → PLAN (GoapPlanner)
  → EXECUTE (PlanExecutor)
     → cache check
     → approval gate for side effects
     → module execution
     → cache store
  → MEMORY (plan + conversation turn)
  → response
  1. Read Install and first run.
  2. Read Configuration profiles.
  3. Run through CLI command reference.
  4. Review Gotchas guide before production use.
  5. Continue with Security model and Governance and policy.

​
Upstream sources

This site is built from the Vitruvian repository code and docs: