Skip to content

garyachy/vppctl-ai

VPPctl AI Agent

License Python 3.8+ VPP PRs Welcome

Natural language CLI for fd.io VPP | High-performance packet processing made easy

An AI-powered assistant for learning and using VPP (Vector Packet Processing). Type natural language, get VPP commands. Perfect for network engineers exploring fd.io, DPDK, and software-defined networking.

vpp-ai> show me all interfaces with IP addresses
Extracted command: show interface addr
Execute 'show interface addr'? [Y/n]: y

              Name               Idx    State  MTU   IP Address
GigabitEthernet0/0/0              1      up    9000  10.0.0.1/24
local0                            0     down    0

vpp-ai> explain what local0 is
local0 is VPP's internal loopback interface used for
punt/inject operations. It stays down during normal use.

Quick Start

# Prerequisites: VPP running, OpenRouter API key (free)
git clone https://github.com/garyachy/vppctl-ai.git
cd vppctl-ai
pip install -r requirements.txt
export OPENROUTER_API_KEY="your-key"  # Get free at openrouter.ai/keys
./run_agent.sh

→ Full Getting Started Guide

Features

  • Natural language → VPP commands
  • Auto-correction when you make typos
  • Explanations of command output
  • TAB completion from VPP itself
  • Hallucination prevention via command validation

Documentation

Document Description
Getting Started Zero to running in 5 minutes
Install VPP VPP installation only
Quick Reference Commands and options
Why This Tool? How it helps you learn VPP

Resources

  • VPP Networking Blog — Deep-dive tutorials on VPP IPsec, IKEv2, Linux Control Plane, and high-performance networking

License

Apache 2.0

About

AI-powered natural language CLI for fd.io VPP | Convert plain English to VPP commands | 1600+ command validation | High-performance packet processing made easy

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors