How justinthoms/network-config-manager works
NCM is a self-hosted network configuration operations manager. Operators add devices, trigger or schedule SSH backups, inspect configuration changes and health, and optionally send masked configuration data for AI review; backups can also be copied off-site. The graph includes administration and security capabilities documented in the README. Router registration and startup wiring are visible in main.py; some service-to-API calls are not shown in the excerpts, so those links are omitted. Several feature branches are documented capabilities rather than inspected implementations.
Main entry points: main.py FastAPI application · ai_review.py AI change review · backups.py Backup endpoints · database.py Application database
Components 30
Application entry
- FastAPI application
backend/app/main.py
Network operations
- Device inventory
backend/app/api/devices.py - Backup endpoints
backend/app/api/backups.py - SSH backup service
backend/app/services/backup.py - Backup schedules
backend/app/services/scheduler.py - Change comparison
backend/app/services/diff.py - Device health
backend/app/api/health.py - Backup file browser
backend/app/api/files.py - Background maintenance
backend/app/services/maintenance.py
AI capabilities
- AI endpoints
backend/app/api/ai.py - AI change review
backend/app/services/ai_review.py - Network assistant
backend/app/services/assistant.py - Language model client
backend/app/services/llm.py - AI provider connections
backend/app/services/ai_providers.py
Administration and security
- Authentication
backend/app/api/auth.py - User administration
backend/app/api/users.py - Security self-check
backend/app/api/security.py - Audit log
backend/app/api/audit.py - Permission hardening
backend/app/services/hardening.py
Persistence and integrations
- Google Drive copies
backend/app/api/cloud.py - OneDrive copies
backend/app/api/onedrive.py - Application database
backend/app/core/database.py - Backup records
backend/app/models/backup.py - AI review records
backend/app/models/ai_review.py - User records
backend/app/models/user.py - Runtime configuration
backend/app/core/config.py
Other components
- NOC operator
- Configured AI service
- Managed network devices
- Cloud storage services
Connections 36
- NOC operator → FastAPI application: uses
README.md - FastAPI application → Device inventory: routes to
backend/app/main.py - FastAPI application → Backup endpoints: routes to
backend/app/main.py - FastAPI application → Device health: routes to
backend/app/main.py - FastAPI application → Backup file browser: routes to
backend/app/main.py - FastAPI application → AI endpoints: routes to
backend/app/main.py - FastAPI application → Authentication: routes to
backend/app/main.py - FastAPI application → User administration: routes to
backend/app/main.py - FastAPI application → Security self-check: routes to
backend/app/main.py - FastAPI application → Audit log: routes to
backend/app/main.py - FastAPI application → Google Drive copies: routes to
backend/app/main.py - FastAPI application → OneDrive copies: routes to
backend/app/main.py - FastAPI application → Application database: initializes
backend/app/main.py - FastAPI application → Backup schedules: starts
backend/app/main.py - FastAPI application → Background maintenance: starts
backend/app/main.py - Managed network devices → SSH backup service: provides configuration
README.md - Backup schedules → SSH backup service: runs scheduled backups
- SSH backup service → Backup records: records backups
- Backup records → Application database: persists in
- Backup endpoints → Change comparison: compares backups
- AI endpoints → AI change review: provides reviews
- AI change review → Change comparison: uses comparison
backend/app/services/ai_review.py - AI change review → Language model client: requests completion
backend/app/services/ai_review.py - AI change review → AI provider connections: selects providers
backend/app/services/ai_review.py - Network assistant → Language model client: uses language models
- Language model client → Configured AI service: sends masked requests
README.md - AI change review → AI review records: stores results
backend/app/services/ai_review.py - AI review records → Application database: persists in
- NOC operator → Device health: checks device health
README.md - Backup endpoints → Google Drive copies: copies backups
- Backup endpoints → OneDrive copies: copies backups
- Google Drive copies → Cloud storage services: uploads copies
README.md - OneDrive copies → Cloud storage services: uploads copies
README.md - Application database → Runtime configuration: uses database settings
backend/app/core/database.py - FastAPI application → Permission hardening: runs startup checks
backend/app/main.py - Authentication → User records: authenticates users
backend/app/api/auth.py