feat: make AI Copilot an optional dependency

This change makes AI Copilot features optional to reduce installation
size and support restricted environments.

Changes:
- Split AI dependencies into ai-requirements.txt
- Add ai-copilot optional dependency in pyproject.toml
- Add import protection in gns3server/agent/__init__.py
- Return 501 for AI endpoints when dependencies not installed
- Add gns3server-uninstall-ai-copilot command for cleanup
- Update README with installation and uninstallation instructions

Installation:
- Basic: pip install gns3-server
- With AI: pip install gns3-server[ai-copilot]
- Development: pip install gns3-server[ai-copilot,dev]

Uninstallation:
- gns3server-uninstall-ai-copilot

gns3server/agent/__init__.py

@@ -0,0 +1,75 @@
+#
+# Copyright (C) 2025 GNS3 Technologies Inc.
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+"""
+Agent module with optional AI Copilot support.
+
+This module provides the AI Copilot functionality as an optional feature.
+If the AI dependencies are not installed, the module will be disabled but
+will not prevent the server from starting.
+
+Installation:
+    pip install gns3-server[ai-copilot]
+"""
+
+import logging
+
+# Feature flag: AI Copilot is available
+AI_COPILOT_AVAILABLE = False
+
+# Try to import AI Copilot components
+try:
+    from .gns3_copilot.project_agent_manager import get_project_agent_manager
+    from .gns3_copilot.project_agent_manager import ProjectAgentManager
+    AI_COPILOT_AVAILABLE = True
+except ImportError as e:
+    # AI dependencies not installed, disable AI Copilot feature
+    logging.warning(
+        f"AI Copilot dependencies not installed: {e}. "
+        "AI features will be disabled. Install with: pip install gns3-server[ai-copilot]"
+    )
+    AI_COPILOT_AVAILABLE = False
+
+    # Provide stub functions that raise helpful errors
+    async def get_project_agent_manager():
+        """
+        Get the global ProjectAgentManager singleton instance.
+
+        Raises:
+            RuntimeError: If AI Copilot dependencies are not installed
+        """
+        raise RuntimeError(
+            "AI Copilot is not available. "
+            "Install AI dependencies with: pip install gns3-server[ai-copilot]"
+        )
+
+    class ProjectAgentManager:
+        """
+        Stub class for ProjectAgentManager when AI dependencies are not installed.
+        """
+
+        def __init__(self):
+            raise RuntimeError(
+                "AI Copilot is not available. "
+                "Install AI dependencies with: pip install gns3-server[ai-copilot]"
+            )
+
+
+__all__ = [
+    "AI_COPILOT_AVAILABLE",
+    "get_project_agent_manager",
+    "ProjectAgentManager",
+]

gns3server/api/routes/controller/__init__.py

@@ -14,16 +14,36 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-from fastapi import APIRouter, Depends
+from fastapi import APIRouter, Depends, HTTPException
+
+# Check AI Copilot availability
+from gns3server.agent import AI_COPILOT_AVAILABLE
+
+# Conditionally import AI-dependent routes
+if AI_COPILOT_AVAILABLE:
+    from . import chat
+    from . import llm_model_configs
+    _chat_router = chat.router
+    _llm_router = llm_model_configs.router
+else:
+    # Create stub routers that return 501 for all AI endpoints
+    _chat_router = APIRouter()
+    _llm_router = APIRouter()
+
+    @_chat_router.api_route("/{path:path}", methods=["GET", "POST", "DELETE", "PATCH", "PUT"])
+    @_llm_router.api_route("/{path:path}", methods=["GET", "POST", "DELETE", "PATCH", "PUT"])
+    async def ai_not_available(path: str = ""):
+        raise HTTPException(
+            status_code=501,
+            detail="AI Copilot is not available. Install AI dependencies with: pip install gns3-server[ai-copilot]"
+        )
 
-from . import chat
 from . import controller
 from . import appliances
 from . import computes
 from . import drawings
 from . import gns3vm
 from . import links
-from . import llm_model_configs
 from . import nodes
 from . import projects
 from . import snapshots
@@ -149,13 +169,13 @@ router.include_router(
 )
 
 router.include_router(
-    llm_model_configs.router,
+    _llm_router,
     prefix="/access",
     tags=["LLM Model Configurations"]
 )
 
 router.include_router(
-    chat.router,
+    _chat_router,
     prefix="/projects/{project_id}/chat",
     tags=["Chat"]
 )

gns3server/schemas/__init__.py

@@ -30,24 +30,31 @@ from .controller.gns3vm import GNS3VM
 from .controller.nodes import NodeCreate, NodeUpdate, NodeDuplicate, NodeCapture, Node
 from .controller.projects import ProjectCreate, ProjectUpdate, ProjectDuplicate, Project, ProjectFile, ProjectCompression
 from .controller.users import UserCreate, UserUpdate, LoggedInUserUpdate, User, Credentials, UserGroupCreate, UserGroupUpdate, UserGroup
-from .controller.llm_model_configs import (
-    LLMModelConfigData,
-    LLMModelConfigCreate,
-    LLMModelConfigUpdate,
-    LLMModelConfigResponse,
-    LLMModelConfigWithSource,
-    LLMModelConfigInheritedResponse,
-    LLMModelConfigListResponse
-)
-from .controller.chat import (
-    OpenAIToolCall,
-    ChatRequest,
-    ChatResponse,
-    OpenAIMessage,
-    ConversationHistory,
-    ChatSession,
-    RenameSession
-)
+
+# Conditionally import AI-related schemas
+try:
+    from .controller.llm_model_configs import (
+        LLMModelConfigData,
+        LLMModelConfigCreate,
+        LLMModelConfigUpdate,
+        LLMModelConfigResponse,
+        LLMModelConfigWithSource,
+        LLMModelConfigInheritedResponse,
+        LLMModelConfigListResponse
+    )
+    from .controller.chat import (
+        OpenAIToolCall,
+        ChatRequest,
+        ChatResponse,
+        OpenAIMessage,
+        ConversationHistory,
+        ChatSession,
+        RenameSession
+    )
+except ImportError:
+    # AI schemas are not available (should not happen as they don't depend on external libs)
+    pass
+
 from .controller.rbac import RoleCreate, RoleUpdate, Role, Privilege, ACECreate, ACEUpdate, ACE
 from .controller.pools import Resource, ResourceCreate, ResourcePoolCreate, ResourcePoolUpdate, ResourcePool
 from .controller.tokens import Token

gns3server/utils/uninstall_ai_copilot.py

@@ -0,0 +1,92 @@
+#!/usr/bin/env python3
+"""
+Uninstall AI Copilot dependencies.
+
+Usage:
+    gns3server-uninstall-ai-copilot
+    gns3server-uninstall-ai-copilot -y
+"""
+
+import os
+import sys
+import subprocess
+import argparse
+
+
+def get_ai_packages():
+    """Read packages from ai-requirements.txt."""
+    # Find the requirements file
+    if hasattr(sys, '_MEIPASS'):
+        # PyInstaller bundle
+        base_dir = os.path.dirname(sys.executable)
+    else:
+        # __file__ = gns3server/utils/uninstall_ai_copilot.py
+        # Need to go up 2 levels to reach project root
+        base_dir = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+    requirements_file = os.path.join(base_dir, "ai-requirements.txt")
+
+    packages = []
+    with open(requirements_file, "r") as f:
+        for line in f:
+            line = line.strip()
+            if not line or line.startswith("#"):
+                continue
+            # Remove version specifiers
+            package = line.split(">=")[0].split("==")[0].split("~=")[0]
+            packages.append(package)
+    return packages
+
+
+def uninstall(packages, yes=False):
+    """Uninstall packages."""
+    if not packages:
+        print("No packages found to uninstall.")
+        return
+
+    print(f"Found {len(packages)} AI Copilot dependencies:")
+    for pkg in packages:
+        print(f"  - {pkg}")
+    print()
+
+    if not yes:
+        response = input("Do you want to uninstall these packages? [y/N]: ")
+        if response.lower() != "y":
+            print("Cancelled.")
+            return
+
+    print("Uninstalling...")
+    for package in packages:
+        try:
+            result = subprocess.run(
+                [sys.executable, "-m", "pip", "uninstall", "-y", package],
+                capture_output=True,
+                text=True
+            )
+            if result.returncode == 0:
+                print(f"  Removed: {package}")
+            else:
+                print(f"  Failed to remove {package} (may not be installed)")
+        except Exception as e:
+            print(f"  Error removing {package}: {e}")
+
+    print("\nAI Copilot dependencies have been uninstalled.")
+    print("You can reinstall them with: pip install gns3-server[ai-copilot]")
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Uninstall AI Copilot dependencies"
+    )
+    parser.add_argument(
+        "-y", "--yes", action="store_true",
+        help="Automatically confirm uninstallation"
+    )
+    args = parser.parse_args()
+
+    packages = get_ai_packages()
+    uninstall(packages, yes=args.yes)
+
+
+if __name__ == "__main__":
+    main()