How cisco-open/network-sketcher works
Network Sketcher turns structured network data and user commands into topology diagrams, device tables, and AI context. The principal workflow is to submit a design through Local MCP, the online web service, or the offline GUI/CLI; the edition’s engine interprets commands and works with a master file, then generates L1/L2/L3 outputs and supporting views. The graph preserves documented edition capabilities and sampled module dependencies. Several subsystem links are documented only at a high level or come from the source index; those are marked dashed where implementation-level evidence is absent.
Main entry points: nsm_adapter.py Online engine adapter · ns_cli.py Offline command engine · nsm_io.py Network master · ns_web_start.py Online web service
Components 25
User interfaces
- Local MCP server
network-sketcher_local_mcp/ns_mcp_server.py - Online web service
network-sketcher_online/ns_web_start.py - Offline GUI
network-sketcher_offline/network_sketcher.py - Offline CLI
network-sketcher_offline/ns_cli.py
Design engine
- Online engine adapter
network-sketcher_online/ns_engine/nsm_adapter.py - Online command engine
network-sketcher_online/ns_engine/nsm_cli.py - Offline command engine
network-sketcher_offline/ns_cli.py
Design outputs
- L1 topology
network-sketcher_online/ns_engine/nsm_l1_diagram_create.py - L2 topology
network-sketcher_online/ns_engine/nsm_l2_diagram_create.py - L3 topology
network-sketcher_online/ns_engine/nsm_l3_diagram_create.py - VPN topology
network-sketcher_offline/ns_vpn_diagram_create.py - SVG rendering
network-sketcher_online/ns_engine/nsm_svg_worker.py - Device table
network-sketcher_online/ns_engine/nsm_device_table_html.py - Combined HTML viewer
network-sketcher_online/ns_engine/nsm_l1l2l3_html.py - PowerPoint figures
network-sketcher_online/ns_engine/nsm_ddx_figure.py - AI context
network-sketcher_online/ns_engine/nsm_ai_context.py
Master and shared services
- Network master
network-sketcher_online/ns_engine/nsm_io.py - Master utilities
network-sketcher_online/ns_engine/nsm_def.py - Offline master utilities
network-sketcher_offline/ns_def.py - Layer synchronization
network-sketcher_online/ns_engine/nsm_sync_between_layers.py - Attribute tables
network-sketcher_online/ns_engine/nsm_attribute_table_from_master.py - Design extensions
network-sketcher_online/ns_engine/nsm_extensions.py
Other components
- LLM client
- Web browser
- Desktop user
Connections 37
- LLM client → Local MCP server: sends tool calls
README.md - Local MCP server → Online engine adapter: runs engine
network-sketcher_local_mcp/ns_mcp_server.py - Local MCP server → AI context: requests context
network-sketcher_local_mcp/ns_mcp_server.py - Local MCP server → Network master: uses file I/O
network-sketcher_local_mcp/ns_mcp_server.py - Web browser → Online web service: submits design
README.md - Online web service → Online engine adapter: runs commands
network-sketcher_online/ns_web_start.py - Online web service → AI context: generates context
network-sketcher_online/ns_web_start.py - Online web service → Device table: serves table
network-sketcher_online/ns_web_start.py - Online web service → Combined HTML viewer: serves viewer
network-sketcher_online/ns_web_start.py - Desktop user → Offline GUI: edits design
README.md - Desktop user → Offline CLI: runs commands
README.md - Offline GUI → Offline command engine: dispatches actions
network-sketcher_offline/network_sketcher.py - Offline GUI → Layer synchronization: synchronizes layers
network-sketcher_offline/network_sketcher.py - Offline CLI → Layer synchronization: synchronizes layers
network-sketcher_offline/ns_cli.py - Online engine adapter → Online command engine: runs commands
network-sketcher_online/ns_engine/nsm_adapter.py - Online engine adapter → Network master: converts master
network-sketcher_online/ns_engine/nsm_adapter.py - Online engine adapter → L1 topology: creates topology
- Online engine adapter → L2 topology: creates topology
- Online engine adapter → L3 topology: creates topology
- Online engine adapter → Device table: creates table
network-sketcher_online/ns_engine/nsm_device_table_html.py - Online engine adapter → SVG rendering: renders SVG
- Online engine adapter → PowerPoint figures: creates figures
- Online engine adapter → VPN topology: supports VPN diagrams
- Offline command engine → Offline master utilities: uses utilities
network-sketcher_offline/ns_cli.py - Offline command engine → L1 topology: builds L1
network-sketcher_offline/ns_cli.py - Offline command engine → L2 topology: builds L2
network-sketcher_offline/ns_cli.py - Offline command engine → L3 topology: builds L3
network-sketcher_offline/ns_cli.py - Offline command engine → Attribute tables: builds tables
network-sketcher_offline/ns_cli.py - Offline command engine → Design extensions: dispatches extensions
network-sketcher_offline/ns_cli.py - L1 topology → Network master: reads master
- L2 topology → Network master: reads master
- L3 topology → Network master: reads master
- Master utilities → Network master: reads master
network-sketcher_online/ns_engine/nsm_def.py - Device table → Master utilities: uses utilities
network-sketcher_online/ns_engine/nsm_device_table_html.py - Attribute tables → Master utilities: uses utilities
- Design extensions → Master utilities: uses utilities
network-sketcher_online/ns_engine/nsm_extensions.py - Design extensions → AI context: supports context
network-sketcher_online/ns_engine/nsm_extensions.py