╔═══════════════════════════════════════════════════════════════════╗
║                                                                   ║
║    ██████╗ ██╗   ██╗███████╗██████╗  █████╗       ███╗   ██╗███████╗████████╗ ║
║   ██╔═══██╗██║   ██║██╔════╝██╔══██╗██╔══██╗      ████╗  ██║██╔════╝╚══██╔══╝ ║
║   ██║   ██║██║   ██║█████╗  ██████╔╝███████║█████╗██╔██╗ ██║█████╗     ██║    ║
║   ██║▄▄ ██║██║   ██║██╔══╝  ██╔══██╗██╔══██║╚════╝██║╚██╗██║██╔══╝     ██║    ║
║   ╚██████╔╝╚██████╔╝███████╗██║  ██║██║  ██║      ██║ ╚████║███████╗   ██║    ║
║    ╚══▀▀═╝  ╚═════╝ ╚══════╝╚═╝  ╚═╝╚═╝  ╚═╝      ╚═╝  ╚═══╝╚══════╝   ╚═╝    ║
║                                                                   ║
║              🌐 Network College CLI Tool 🌐                        ║
║                                                                   ║
╚═══════════════════════════════════════════════════════════════════╝

A beautiful CLI tool for Quera Network College - GNS3 network exercises made easy!

🧭 What is Quera-Net?

Quera-Net is a developer-friendly CLI tool designed to simplify and automate GNS3-based networking exercises for Quera Network College. It removes the complexity of manual setup, letting you focus purely on learning and practicing networking concepts.

Whether you're a beginner or an advanced learner, Quera-Net streamlines environment setup, lesson management, and submission workflows into a smooth, guided experience.

---

🎯 Why Use Quera-Net?

Setting up networking labs can be time-consuming and error-prone. Quera-Net solves this by providing a fully automated, consistent, and visually appealing interface for managing your lab environment.

With Quera-Net, you can:

• ⚡ Skip manual configuration and start instantly
• 🔄 Stay synced with the latest course requirements
• 🧪 Experiment safely in isolated Docker environments
• 🎨 Enjoy a modern, themed CLI experience
• 📦 Manage everything from setup to submission in one place

---

✨ Features

• 🚀 One-Command Setup - Initialize your entire GNS3 environment with a single command
• 🌐 Server-Synced Config - Automatically fetches latest configurations from Quera server
• 🎨 Beautiful UI - Gorgeous terminal interface with multiple color themes
• 🔍 Smart Checks - Automatic system requirements verification
• 🐳 Docker Integration - Seamless Docker management
• 📚 Easy Lessons - Setup and submit exercises effortlessly
• 🌍 Cross-Platform - Works on Linux, macOS, and Windows

---

📦 Installation

One-Line Install (Recommended)

Linux / macOS:

curl -fsSL https://raw.githubusercontent.com/dwin-gharibi/quera-net/main/scripts/install.sh | bash

Or using wget:

wget -qO- https://raw.githubusercontent.com/dwin-gharibi/quera-net/main/scripts/install.sh | bash

Windows (PowerShell as Administrator):

irm https://raw.githubusercontent.com/dwin-gharibi/quera-net/main/scripts/install.ps1 | iex

Using pip

pip install quera-net

Using pipx (Isolated Environment)

pipx install quera-net

From Source

git clone https://github.com/dwin-gharibi/quera-net.git
cd quera-net
pip install -e .

---

🚀 Quick Start

1. Initialize Environment

quera-net init

This will:

• ✅ Fetch latest configuration from Quera server
• ✅ Check system requirements (RAM, OS, Docker)
• ✅ Pull the required Docker image
• ✅ Create configuration files
• ✅ Start the GNS3 container
• ✅ Open GNS3 in your browser

2. Setup a Lesson

quera-net setup 295501

Replace 295501 with your lesson ID from Quera.

3. Submit Your Solution

quera-net submit 295501

---

📖 Commands

Command	Description
quera-net init	🚀 Initialize the environment
quera-net setup <id>	📚 Setup a lesson by ID
quera-net submit <id>	📤 Submit your solution
quera-net status	📊 Show environment status
quera-net start	▶️ Start GNS3 container
quera-net stop	⏹️ Stop GNS3 container
quera-net restart	🔄 Restart GNS3 container
quera-net logs	📜 Show container logs
quera-net open-gns3	🌐 Open GNS3 in browser
quera-net themes	🎨 List available themes
quera-net clean	🧹 Clean up containers

Command Options

quera-net init --skip-checks
quera-net init --no-pull
quera-net init --offline
quera-net init --force

quera-net logs --follow
quera-net logs --lines 100

---

🎨 Themes

Quera-Net comes with beautiful color themes! Use the --theme flag with any command:

quera-net status --theme cyberpunk
quera-net init --theme matrix
quera-net setup 295501 --theme ocean

Available themes:

Theme	Description
🟣 quera	Default - Elegant indigo and purple
🟢 matrix	Hacker green vibes
🔵 ocean	Calm and professional blue
🟠 sunset	Warm coral tones
🟡 cyberpunk	Neon pink and cyan

Preview all themes:

quera-net themes

---

💻 System Requirements

Requirement	Minimum
RAM	4 GB
Disk Space	10 GB
Docker	Latest
Python	3.8+

Supported Operating Systems

• ✅ Linux - Ubuntu, Debian, Fedora, CentOS, Arch, etc.
• ✅ macOS - 10.15 (Catalina) and later
• ✅ Windows - 10/11 with WSL2 and Docker Desktop

---

🔧 Configuration

Quera-Net stores its configuration in ~/.quera-net/:

~/.quera-net/
├── docker-compose.yml
├── config_cache.json
└── data/
    └── ...

Server Configuration

The CLI fetches configuration from the Quera server including:

• Docker image versions
• System requirements
• docker-compose.yml content

Use --offline flag to skip server fetch and use cached/default values.

---

🛠️ Development

Setup Development Environment

# Clone the repository
git clone https://github.com/dwin-gharibi/quera-net.git
cd quera-net

# Install with dev dependencies
make dev
# or
pip install -e ".[dev]"

# Run linting
make lint

# Run tests
make test

# Build package
make build

Project Structure

quera-net/
├── quera_net/
│   ├── __init__.py
│   ├── cli.py
│   ├── core/
│   │   ├── api.py
│   │   ├── config.py
│   │   ├── docker_manager.py
│   │   └── system_check.py
│   ├── ui/
│   │   ├── components.py
│   │   └── themes.py
│   └── utils/
│       ├── network.py
│       └── platform.py
├── scripts/
│   ├── install.sh
│   └── install.ps1
├── .github/workflows/
│   ├── ci.yml
│   ├── publish.yml
│   └── release.yml
├── pyproject.toml
├── Makefile
└── README.md

---

🆘 Troubleshooting

Docker not found

Linux:

curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
# Log out and log back in

macOS/Windows: Download Docker Desktop

Container won't start

# Check logs
quera-net logs

# Restart container
quera-net restart

# Full reset
quera-net clean --all
quera-net init

GNS3 not accessible

1. Make sure the container is running: quera-net status
2. Check if port 3080 is available
3. Try restarting: quera-net restart

Permission denied (Linux)

# Add user to docker group
sudo usermod -aG docker $USER
# Log out and log back in

---

🔗 Links

• 📚 Quera Network College
• 🐛 Report Issues
• 📦 PyPI Package

---

Made with ❤️ by Quera

Happy Networking! 🌐