Getting Started

Install snmpkit and set up your environment.

Installation

pip


pip install snmpkit

uv


uv add snmpkit

pdm


pdm add snmpkit

Requirements

Python 3.14+

For Agent (AgentX) support, you also need:

Net-SNMP (snmpd with AgentX enabled)

Installing Net-SNMP (Agent only)

Ubuntu/Debian


sudo apt install snmpd snmp libsnmp-dev

RHEL/CentOS


sudo dnf install net-snmp net-snmp-utils net-snmp-devel

macOS


brew install net-snmp

Verify Installation


import snmpkit
print(snmpkit.__version__)

Configure snmpd for AgentX (Agent only)

To use snmpkit agents, enable AgentX in snmpd:

/etc/snmp/snmpd.conf


# Enable AgentX master agent
master agentx
agentXSocket /var/agentx/master

# Allow read access
rocommunity public

# Allow write access (for SET operations)
rwcommunity private

Restart snmpd:


sudo systemctl restart snmpd

The default AgentX socket is /var/agentx/master. Make sure your user has permission to connect to it.

Next Steps

Choose your path:

Manager Guide — Query and monitor SNMP devices
Manager Quickstart — Start polling devices
Agent Guide — Build SNMP agents that expose data
Agent Quickstart — Jump straight to agent code