🚀 nso‑rocket

Key Files

• 📘 Setup Guide
• ⚡ Flagship Drift Workflow
• 🤖 AGNTCY Drift Agent Manifest

Launch NSO to new heights with AGNTCY multi‑agents & n8n automation
Transform NSO operations with intelligent multi‑agent automation. Combines AGNTCY's agent framework with n8n workflows to eliminate config drift, accelerate deployments & reduce complexity.

Overview

nso-rocket is designed as a modular automation and execution layer for Cisco NSO, combining workflow automation, agent-based intelligence, and observability tooling through well defined integration.

n8n — Workflow Automation & Event Handling

nso-rocket uses n8n as the workflow and event-orchestration layer. n8n is responsible for:

• Triggering NSO workflows based on external events (API calls, schedules, webhooks)
• Coordinating multi-step automation such as inventory discovery, service deployment, and drift checks
• Handling retries, branching logic, and asynchronous execution outside of NSO itself

In this architecture, n8n acts as the automation conductor, while nso-rocket provides the NSO-specific logic and execution steps that n8n invokes.

n8n: https://n8n.io/

AGNTCY — Agent-Based Intelligence & Orchestration

nso-rocket integrates with the AGNTCY Multi-Agent Framework to support agent-driven decision-making and orchestration. AGNTCY agents can:

• Decide when to run nso-rocket workflows (e.g., based on detected drift, policy signals, or intent)
• Select which automation paths to execute (read-only validation vs. remediation)
• Coordinate multiple automation actions across systems while treating nso-rocket as a reliable execution backend

In this model, AGNTCY provides the reasoning and coordination layer, while nso-rocket serves as the deterministic, auditable automation executor for network changes via Cisco NSO.

AGNTCY: https://github.com/AGNTCY

Grafana — Observability, Reporting, and Audit Visibility

nso-rocket integrates with Grafana for visualization and operational insight into automation activity. Workflow outputs from nso-rocket (such as execution status, device counts, drift results, and timing data) can be surfaced as metrics or logs and visualized in Grafana dashboards.

This enables teams to:

• Monitor automation health and success rates over time
• Visualize drift trends and affected services/devices
• Provide audit-friendly views for change management and compliance reporting

Grafana: https://grafana.com/grafana/

Together, n8n, AGNTCY, and Grafana allow nso-rocket to participate cleanly in agent driven, event based network operations while keeping Cisco NSO as the authoritative source of truth.
Designed for enterprise network teams and automation engineers who need speed, intelligence, and reliability in their NSO environments.

Repository Structure

NSO-Rocket/
├── workflows/            # n8n workflows (discovery, compliance, monitoring, operations)
│   ├── compliance/       # Drift detection, standardization, remediation
│   ├── discovery/        # Brownfield network scan & service discovery
│   ├── integration/      # Legacy bridges & API translation
│   ├── monitoring/       # Performance metrics & health dashboards
│   └── operations/       # Service deployment & rollback
├── agntcy/               # AGNTCY multi‑agent definitions
│   ├── schemas/          # OASF agent schemas
│   ├── agents/           # Multi‑agent configurations
│   └── manifests/        # Agent workflow manifests
├── configs/              # Async & topology weighting configs
├── dashboards/           # Grafana/n8n dashboards
├── documentation/        # Setup, workflow guides, troubleshooting
├── scripts/              # Helper & transformer scripts
├── templates/            # Device configs, service templates, YANG models
└── examples/             # Demo environments & use case scenarios

Key Features

• ✅ Async Drift Detection — Parallel API calls for lightning-fast checks
• ✅ Topology-Aware Prioritization — Core devices prioritized automatically
• ✅ Multi-Agent Orchestration — AGNTCY semantic routing & workflow chaining
• ✅ Dashboards — Real-time drift trends, compliance health, remediation history
• ✅ Multi-Vendor Ready — Templates & workflows for Cisco, Juniper, Arista, more
• ✅ Brownfield Discovery — Migrate existing services into NSO with minimal friction

Quick Start

1. Clone the Repository

git clone https://github.com/<your-username>/NSO-Rocket.git
cd NSO-Rocket

2. Open in VSCode

code .

3. Setup Environment

• Install n8n (installation guide)
• Configure NSO API credentials in configs/async-settings.json
• Adjust topology weights in configs/topology-weights.json

4. Import Workflows

• In n8n, import workflows from workflows/ (start with compliance/config-drift-detection.json)

5. Run Drift Detection

• Trigger drift detection workflow in n8n
• View results in Slack (alerts) or Grafana (dashboards in dashboards/)

Integrations

• Cisco NSO — API integration for device configs & service state
• n8n — Workflow engine for orchestration & automation
• AGNTCY — Multi‑agent interoperability & semantic routing
• Grafana — Optional visualization for drift, compliance, and health trends

Roadmap

License

MIT License — see LICENSE

Contributing

Pull requests welcome! Check documentation/setup-guide.md for contribution guidelines.