OVERVIEW

Verdaca docs

This documentation covers Verdaca's deliberation platform — how it is architected, how to run your first session, and how to extend it with custom agents and adapter substrates. It is written for practitioners: consultants, engineers, and technical leads who need to understand the system well enough to configure and deploy it.

ADVISORY

Start with the Conceptual model before touching configuration — the two-axis pluggability diagram is the key to understanding every other section.

What's in these docs

Overview (this page) — What Verdaca is and how these docs are organized.
Getting started — Installation, first session, and configuration essentials.
Conceptual model — Two-axis architecture, deliberation loop, and kernel responsibilities.
Agent catalog — Available personas, capabilities, and how to load them.
Build your own agent — Define a custom persona and bind it to a session.
Workflow recipes — Pre-built deliberation patterns ready to run or adapt.
Output review — Scoring, audit trails, and custom rubrics.

Quick start

Three lines to run a deliberation session. Install the package, initialize a Studio, and pass a workflow name.

# Install Verdaca
pip install verdaca

# Initialise a session
from verdaca import Studio
session = Studio.create()
result  = session.run("[workflow-placeholder]")

Architecture at a glance

Verdaca is organized on two independent axes: swap the agent personas horizontally, swap the substrate adapters vertically. Neither axis requires changing the other.

  HORIZONTAL AXIS — PLUG-IN PERSONAS
  ┌─────────────┬─────────────┬─────────────┬─────────────┐
  │   UX expert │  Data sci.  │ Legal csl.  │ Sec. arch.  │
  └──────┬──────┴──────┬──────┴──────┬──────┴──────┬──────┘
         │             │             │             │
         ▼             ▼             ▼             ▼
  ┌─────────────────────────────────────────────────────────┐
  │                  VERDACA KERNEL                         │
  └───────────────────────┬─────────────────────────────────┘
                          │
  VERTICAL AXIS — SUBSTRATE-NEUTRAL ADAPTERS
  ┌──────────┬────────────┴──────────┬──────────────────────┐
  │  Memory  │     LLM provider      │  Compaction / output │
  │ Mem0│Letta│ Anthropic │ OpenAI   │  Forge  │  Caveman   │
  └──────────┴───────────────────────┴──────────────────────┘