How abdisamad001/toposcribe-ai works
TopoScribe AI turns a natural-language campus-network request into a planned topology, device configuration, validation result, and exportable design. The principal workflow runs from the design API through LangGraph’s planning, topology, configuration, and validation stages; users can clarify requirements and work with the resulting topology in the Next.js editor. Separate capabilities cover saved designs, projects, chats, reports, simulation, and optional Packet Tracer verification. Edges reflect excerpts, the source index, or README documentation; unsampled subsystem links are omitted where callers are not evidenced.
Main entry points: workflow.py Agent workflow · TopologyEditor.tsx Topology editor · planning_agent.py Requirements planning · topology_agent.py Topology generation
Components 25
Design workspace
- Topology editor
frontend/src/components/topology/TopologyEditor.tsx - Configuration panel
frontend/src/components/topology/ConfigPanel.tsx - Packet Tracer panel
frontend/src/components/topology/PacketTracerPanel.tsx
Design generation
- Design endpoint
backend/app/api/design.py - Agent workflow
backend/app/graph/workflow.py - Design state
backend/app/graph/state.py - Requirements planning
backend/app/agents/planning_agent.py - Topology generation
backend/app/agents/topology_agent.py - Configuration generation
backend/app/agents/config_agent.py - Configuration validation
backend/app/agents/validation_agent.py - LLM client
backend/app/utils/llm.py - Planning helpers
backend/app/utils/planning_helpers.py
Network outputs
- Topology layout
backend/app/generators/topology_layout.py - Config builder
backend/app/generators/config_builder.py - Cisco configuration
backend/app/generators/cisco.py - Network model
backend/app/models/network.py
Saved work
- Design database
backend/app/db.py - Projects, chats, reports
backend/app/api
Simulation and verification
- Reachability endpoint
backend/app/api/simulate.py - Reachability simulation
backend/app/simulation/reachability.py - Packet Tracer endpoint
backend/app/api/packettracer.py - Packet Tracer client
backend/app/integrations/packettracer/client.py - Packet Tracer worker
backend/app/integrations/packettracer/mcp_worker.py
Other components
- Network designer
- Packet Tracer bridge
Connections 26
- Network designer → Topology editor: describes network
- Topology editor → Design endpoint: requests design
- Design endpoint → Agent workflow: runs workflow
backend/app/api/design.py - Agent workflow → Requirements planning: dispatches
backend/app/graph/workflow.py - Agent workflow → Topology generation: dispatches
backend/app/graph/workflow.py - Agent workflow → Configuration generation: dispatches
backend/app/graph/workflow.py - Agent workflow → Configuration validation: dispatches
backend/app/graph/workflow.py - Requirements planning → LLM client: calls
backend/app/agents/planning_agent.py - Requirements planning → Planning helpers: uses
backend/app/agents/planning_agent.py - Topology generation → LLM client: calls
backend/app/agents/topology_agent.py - Topology generation → Topology layout: uses
backend/app/agents/topology_agent.py - Configuration generation → Config builder: builds configuration
backend/app/agents/config_agent.py - Configuration validation → Cisco configuration: checks configuration
backend/app/agents/validation_agent.py - Agent workflow → Design state: shares state
backend/app/graph/workflow.py - Design state → Network model: types topology
backend/app/graph/state.py - Topology layout → Network model: produces topology
backend/app/generators/topology_layout.py - Topology editor → Configuration panel: renders
frontend/src/components/topology/TopologyEditor.tsx - Topology editor → Packet Tracer panel: renders
frontend/src/components/topology/TopologyEditor.tsx - Network designer → Projects, chats, reports: manages saved work
- Projects, chats, reports → Design database: reads and writes
backend/app/api/chats.py - Reachability endpoint → Reachability simulation: runs checks
backend/app/api/simulate.py - Reachability endpoint → Network model: accepts topology
backend/app/api/simulate.py - Packet Tracer endpoint → Packet Tracer client: requests execution
backend/app/api/packettracer.py - Packet Tracer client → Packet Tracer worker: launches worker
backend/app/integrations/packettracer/client.py - Packet Tracer worker → Packet Tracer bridge: calls MCP tools
backend/app/integrations/packettracer/mcp_worker.py - Topology editor → Packet Tracer client: starts verification