Skip to content

Quickstart Masterclass

import { Steps } from โ€˜@astrojs/starlight/componentsโ€™;

Welcome to AgentV. This guide gets you from a fresh installation to your first Forensic Evaluation in under two minutes. No API keys, cloud accounts, or complex configurations are required for this initial walkthrough.

  1. Environment Setup
    Create a clean virtual environment and install the harness in editable mode.

    Terminal window
    python -m venv venv
    venv\Scripts\activate
    pip install -e ".[dev]"
  2. Initialize the Industrial Corpus
    Scaffold the necessary local directories and download a lightweight, deterministic evaluation suite.

    Terminal window
    agentv quickstart
  3. Execute a Deterministic Run
    Run a pre-configured scenario using the Zero-Temperature Mock Adapter. This verifies your local routing and event bus without incurring LLM costs.

    Terminal window
    agentv evaluate --path industries/finance/scenarios/loan_approval.json
  4. Visual Triage
    Launch the Integrated Console to inspect the behavioral DNA of your run.

    Terminal window
    agentv console

    Open http://localhost:5000 in your browser to see the trajectory, state deltas, and the forensic ledger.


When you ran evaluate, the AgentV engine executed several industrial-grade protocols:

  • Isolated Routing: The engine consulted .aes/config/routing/manifest.json to map the scenarioโ€™s requirements to a local simulator.
  • Event-Driven Observation: Every tool call and reasoning step was emitted to the Global Event Bus, allowing the dashboard to mirror the execution in real-time.
  • Forensic Ledger Creation: A SHA3-256 hash was generated for the trace, binding the results to your local Identity Registry.