Skip to content

Quick Start

Get your network visible to OLAV in 5 minutes: install, configure devices, collect data, ask your first question.

Feature Claims

ID Claim Status
C-NE-01 /netops_init --dry-run passes environment checks after installing olav-netops ⬜ Pending
C-NE-02 olav list includes ops-orchestrator after olav-netops is installed ⬜ Pending
C-NE-03 /netops_init collects device data and populates netops.parsed_outputs 🔶 Env-Blocked
C-NE-04 /netops_init generates topology links from LLDP/CDP discovery data 🔶 Env-Blocked

Step 1: Install olav-netops

pip install olav-netops

cd olav
uv pip install -e olav-netops/

Verify the extension is loaded:

olav list

Expected output includes:

  • ops  (or ops-orchestrator)
    Deep troubleshooting with full ReAct loop; includes lab emulation for CAB validation
    Location: .olav/workspace/ops/

Step 2: Configure Your Devices

Edit the Nornir inventory to define your network devices:

# Create or edit the hosts file
nano .olav/workspace/ops/config/nornir/hosts.yaml

Example hosts.yaml:

R1:
  hostname: 10.0.1.1
  platform: cisco_ios
  groups:
    - core_routers

R2:
  hostname: 10.0.1.2
  platform: cisco_ios
  groups:
    - core_routers

Group defaults go in groups.yaml:

core_routers:
  username: admin
  password: "${NORNIR_PASSWORD}"
  connection_options:
    netmiko:
      extras:
        timeout: 30

Step 3: Run Initialization

olav --agent ops "/netops_init"

This runs a 5-stage pipeline:

Stage What happens
0 Checks environment: Nornir config, LLM availability, workspace
1 SSH to all devices, run show commands, parse with TextFSM
2 Analyze parse gaps (P0 critical / P1 important / P2 optional)
3 Auto-repair parse failures, verify discovery commands (CDP/LLDP)
4 Build topology graph from LLDP/CDP neighbor data
5 Register daily collection cron job

Dry run first

Test your environment without touching devices: 

olav --agent ops "/netops_init --dry-run"

Step 4: Ask Your First Question

olav "How many devices are in my network?"

olav "Show me the topology"

olav "Are all BGP neighbors established?"

OLAV queries the collected data in DuckDB and returns structured answers. No device access is needed for queries — everything comes from the snapshot database.

What's Next?

  • Basic Concepts — Understand how snapshots, templates, and agents work
  • Quick Agent — Daily queries and CLI execution
  • Ops Agent — Deep analysis, simulation, and drift detection