Quick Start

Get started with VBAgent in 5 minutes!

1. Initialize Workspace

vbagent init

This creates .vbagent.json with your preferences (subject, models, etc.).

2. Process Your First Image

vbagent process -i question.png

This will: - Classify the question type - Extract LaTeX - Generate TikZ diagrams (if present) - Assess difficulty - Save everything with metadata

Output:

agentic/
├── scans/problem_1.tex          (with metadata)
├── classifications/problem_1.json
├── diagrams/problem_1.json
├── difficulty/problem_1.json
└── tikz/problem_1.tex

3. Try the Chat Interface

vbagent chat

Example conversation:

You: "Generate a passage problem on friction in Mechanics with 3 questions"

Agent: *generates complete problem with TikZ and metadata*

4. Create a DPP Set

vbagent dpp create -n 10

Creates a balanced 10-question practice set from your question bank.

Common Workflows

Scan Multiple Images

vbagent batch init -i ./images -o ./output
vbagent batch continue

Generate Variants

vbagent variant -i question.png --type numerical -n 3

Database Management

# Initialize database
vbagent db init ./questions

# Query questions
vbagent db query --topic Mechanics --difficulty medium