🌐 NetSketch AI

NetSketch AI es una herramienta en Python que genera automáticamente diagramas de red con imágenes reales de dispositivos (PC, switches, routers, etc.), usando Graphviz y modelos de lenguaje como Gemini (API de Google AI). Ideal para profesionales de redes, docentes y estudiantes que necesitan representaciones visuales precisas y estéticas.

---

🧠 Características

• 🖼️ Usa imágenes reales en lugar de íconos genéricos.
• 🔗 Integración con la API de Gemini para describir o expandir topologías.
• 🖥️ Generación automática de archivos .dot y exportación a .png.
• 📂 Organización clara de carpetas y archivos.
• 💻 Código limpio y modular con estructura profesional.

---

📁 Estructura del proyecto

NetSketch-AI/
├── images/ # Imágenes de los dispositivos
│ ├── PC.jpg
│ ├── Router.jpg
│ ├── Switch.jpg
│
├── output/ # Diagramas generados automáticamente
│ ├── diagrama_red.dot
│ └── diagrama_red.png
│
├── src/ # Código fuente del generador
│ └── net_sketch.py
│
├── .env # Variables de entorno (API KEY de Gemini)
├── .gitignore # Exclusiones para Git
├── requirements.txt # Dependencias del proyecto
└── README.md # Este archivo

🚀 Cómo usarlo

1. Clona este repositorio:

   git clone https://github.com/dollyrm14/NetSketch-AI.git
   cd NetSketch-AI
   

2. Instala las dependencias:

pip install -r requirements.txt

3. Agrega tu API Key de Google Gemini en un archivo .env en la raíz del proyecto:

GEMINI_API_KEY=tu_clave_aquí

4. Ejecuta el generador de topologías:

python src/net_sketch.py

📍 El diagrama generado estará en: output/diagrama_red.png

🖼️ Capturas de pantalla

📌 Ejemplo de ejecución

🖼️ Diagrama generado

📸 ejecución carpeta /docs.

🛠️ Tecnologías utilizadas

🐍 Python 3.10+

🌐 Graphviz

🖼️ Pillow (para manejo de imágenes)

🤖 Google AI Gemini (para descripciones automáticas futuras)

👩‍💻 Autor

Doly Rodríguez 📍 Ricaurte, Colombia 📧 [email protected] 💼 GitHub: @dollyrm14

💡 Inspiración

La idea surgió de la necesidad de representar topologías reales de red, con una visual profesional y clara, ideal para documentación técnica y presentaciones educativas.

📌 Próximos pasos

🌐 Interfaz web con Streamlit.

🤖 Integración completa con Gemini AI.

☁️ Exportación a PDF y SVG.(planeado)

🧩 Soporte para nuevas familias de dispositivos (firewalls, APs, etc.).

🛜 Edición visual de la topología con drag & drop (futuro).

⭐ Si te resulta útil este proyecto, no olvides darle una estrella en GitHub.

¡Tu apoyo impulsa nuevas ideas! 💡