SNATT is available as both a desktop application (Python + CustomTkinter) and a web application (React + Vite). Choose the version that fits your needs:

• Desktop: Direct SSH connections, local operations, full network device access
• Web: Browser-based, no installation, team collaboration, Vercel-deployable

Both versions share the same 5 core panels: Discovery, Diagnostics, Backup, Reports, and Settings.

• 🔍 Automated Network Discovery - Scan subnets and identify routers/switches automatically
• 🔐 Secure Connection Management - SSH-based connections with encrypted credential storage
• 🧰 Intelligent Troubleshooting - Execute diagnostic workflows and identify issues automatically
• 💾 Configuration Backup - Batch backup with version control and timestamping
• 📊 Professional Reporting - Generate Excel/PDF reports with health summaries
• 🖥️ Modern GUI - Intuitive interface with color-coded status indicators

Prerequisites:

• Python 3.8 or higher
• pip package manager
• Network access to devices you want to manage

Installation:

1. Clone the repository:

   git clone https://github.com/LingeshwarKulal/SNATT.git
   cd SNATT

2. Create a virtual environment (recommended):

   python -m venv venv
   .\venv\Scripts\Activate.ps1

3. Install dependencies:

   pip install -r requirements.txt

4. Run the application:

   python src/main.py

Prerequisites:

• Node.js 18+ and npm

Local Development:

1. Navigate to React app:

   cd snatt-react

2. Install dependencies:

   npm install

3. Run development server:

   npm run dev

   Visit http://localhost:5173

4. Build for production:

   npm run build

Deploy to Vercel:

1. Go to vercel.com
2. Import LingeshwarKulal/SNATT
3. Set Root Directory to snatt-react
4. Deploy!

See REACT_DEPLOYMENT.md for detailed instructions.

automa/
├── src/                          # Source code
│   ├── main.py                   # Application entry point
│   ├── gui/                      # GUI components
│   │   ├── main_window.py
│   │   ├── discovery_panel.py
│   │   ├── diagnostics_panel.py
│   │   ├── backup_panel.py
│   │   ├── reports_panel.py
│   │   └── settings_panel.py
│   ├── engines/                  # Core business logic
│   │   ├── discovery_engine.py
│   │   ├── connection_manager.py
│   │   ├── troubleshooting_engine.py
│   │   ├── backup_manager.py
│   │   └── reporting_engine.py
│   ├── models/                   # Data models
│   │   ├── device.py
│   │   ├── diagnostic_result.py
│   │   └── backup_record.py
│   ├── utils/                    # Utility functions
│   │   ├── logger.py
│   │   ├── credential_manager.py
│   │   ├── config_manager.py
│   │   └── validators.py
│   └── resources/                # Static resources
│       ├── icons/
│       └── templates/
├── tests/                        # Test suite
│   ├── unit/
│   ├── integration/
│   └── test_data/
├── backups/                      # Device configuration backups
├── reports/                      # Generated reports
├── logs/                         # Application logs
├── docs/                         # Documentation
│   ├── user_guide.md
│   ├── api_reference.md
│   └── architecture.md
├── config/                       # Configuration files
│   └── default_config.json
├── requirements.txt              # Python dependencies
├── setup.py                      # Package setup
├── .gitignore                    # Git ignore rules
├── LICENSE                       # MIT License
├── PRD.md                        # Product Requirements Document
└── README.md                     # This file

• GUI Framework: CustomTkinter (modern themed UI)
• Network Automation: Netmiko, NAPALM, Paramiko
• Network Discovery: Scapy, PySNMP
• Reporting: Pandas, OpenPyXL, ReportLab
• Data Storage: SQLite, JSON
• Security: Keyring (credential encryption)
• Testing: Pytest
• Code Quality: Black, Flake8

1. Launch SNATT and navigate to the Discovery tab
2. Enter your subnet (e.g., 192.168.1.0/24)
3. Click Scan Network
4. Review discovered devices in the results table
5. Select devices and click Connect

1. Navigate to the Diagnostics tab
2. Select one or more connected devices
3. Choose a diagnostic workflow (Interface Health, CPU Check, etc.)
4. Click Run Diagnostics
5. Review results with color-coded indicators

1. Navigate to the Backup tab
2. Select devices to backup
3. Choose configuration type (running/startup)
4. Click Backup Now
5. View backup history and compare versions

1. Navigate to the Reports tab
2. Select report type and date range
3. Choose export format (Excel/PDF)
4. Click Generate Report
5. Report opens automatically

• Credential Storage: Encrypted using OS keyring
• Communication: SSH only (no plaintext protocols)
• Audit Logging: All actions logged with timestamps
• Input Validation: All user inputs sanitized

Run the test suite:

# All tests
pytest

# Unit tests only
pytest tests/unit/

# Integration tests
pytest tests/integration/

# With coverage report
pytest --cov=src --cov-report=html

Problem: Application won't start

• Solution: Ensure Python 3.8+ is installed, check python --version

Problem: Cannot discover devices

• Solution: Check network connectivity, firewall rules, ICMP enabled

Problem: SSH connection fails

• Solution: Verify credentials, ensure SSH enabled on devices, check port 22

Problem: Reports not generating

• Solution: Check write permissions in reports/ directory

Application logs are stored in logs/snatt.log. Check this file for detailed error messages.

Contributions are welcome! Please follow these steps:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

• Follow PEP 8 style guide
• Add docstrings to all functions
• Write unit tests for new features
• Update documentation as needed

This project is licensed under the MIT License - see the LICENSE file for details.

• Project structure
• Basic network discovery
• SSH connection to Cisco devices
• Simple configuration backup
• Basic GUI

• Multi-vendor support
• Complete troubleshooting workflows
• Batch operations
• Excel/PDF reporting
• Full GUI implementation

• Configuration diff viewer
• Scheduled backups
• Custom workflows
• API integrations

• Multi-user support
• Web dashboard
• SNMP monitoring
• ML anomaly detection

• Documentation: docs/
• Issues: Report bugs and feature requests in the Issues section
• Email: [email protected] (placeholder)

• Built with CustomTkinter
• Network automation powered by Netmiko
• Inspired by the network engineering community

Made with ❤️ for Network Engineers

Last Updated: October 5, 2025