Qubinode Navigator

Modern Enterprise Infrastructure Automation Platform

Qubinode Navigator is an AI-enhanced, container-first infrastructure automation platform that provides hypervisor deployment and management capabilities across multiple cloud providers and operating systems. Built with a modular plugin architecture, it supports the latest enterprise Linux distributions including RHEL 10 and CentOS Stream 10.

TL;DR

Qubinode Navigator - Modern Enterprise Infrastructure Automation Platform with AI-powered MCP servers.

Key features:

• 🔌 Modular Plugin Architecture: Extensible framework with OS, cloud provider, and deployment plugins
• 🤖 AI-Powered MCP Servers: Model Context Protocol integration for LLM-driven infrastructure management
• Airflow MCP Server: DAG management and VM operations (9 tools)
• AI Assistant MCP Server: RAG-powered documentation search and chat (3 tools)

Quick start: git clone https://github.com/Qubinode/qubinode_navigator.git && cd qubinode_navigator && sudo -E ./scripts/development/deploy-qubinode.sh

🚀 Key Features

• 🔌 Modular Plugin Architecture: Extensible framework with OS, cloud provider, and deployment plugins
• 🤖 AI-Powered MCP Servers: Model Context Protocol integration for LLM-driven infrastructure management
  • Airflow MCP Server: DAG management and VM operations (9 tools)
  • AI Assistant MCP Server: RAG-powered documentation search and chat (3 tools)
• 📦 Container-First Execution: All deployments use Ansible Navigator with standardized execution environments
• 🌐 Multi-Cloud Support: Equinix, Hetzner, AWS, and bare-metal deployments
• 🔒 Enterprise Security: Ansible Vault integration with HashiCorp Vault support
• 📊 Automated Updates: Intelligent update detection and compatibility validation (planned)

🖥️ Supported Platforms

• RHEL 8/9/10 - Full enterprise support with subscription management
• CentOS Stream 10 - Next-generation enterprise Linux
• Rocky Linux - RHEL-compatible community distribution
• Fedora - Cutting-edge features and packages

📋 Prerequisites

• Linux-based operating system (RHEL 8+, CentOS, Rocky Linux, or Fedora)
• Git
• Podman or Docker
• 4GB+ RAM (8GB+ recommended for AI features)

🚀 Quick Start

Modern Setup (Recommended)

# Clone the repository
git clone https://github.com/Qubinode/qubinode_navigator.git
cd qubinode_navigator

# Run pre-flight checks
./scripts/preflight-check.sh --fix

# Deploy everything (AI Assistant + Airflow + PostgreSQL)
sudo -E ./scripts/development/deploy-qubinode.sh

Running as Non-Root User

For security best practices, you can run as a dedicated lab-user instead of root:

# Create lab-user with sudo privileges
curl -OL https://gist.githubusercontent.com/tosin2013/385054f345ff7129df6167631156fa2a/raw/b67866c8d0ec220c393ea83d2c7056f33c472e65/configure-sudo-user.sh
chmod +x configure-sudo-user.sh
./configure-sudo-user.sh lab-user

# Switch to lab-user and configure SSH
sudo su - lab-user
ssh-keygen -f ~/.ssh/id_rsa -t rsa -N ''
IP_ADDRESS=$(hostname -I | awk '{print $1}')
ssh-copy-id lab-user@${IP_ADDRESS}

See the Getting Started Guide for complete non-root setup instructions.

Legacy Setup

curl https://raw.githubusercontent.com/Qubinode/qubinode_navigator/main/setup.sh | bash

Plugin Framework CLI

# List available plugins
python3 qubinode_cli.py list

# Deploy with specific OS plugin
python3 qubinode_cli.py deploy --plugin rhel10

# Get plugin information
python3 qubinode_cli.py info --plugin rocky_linux

🏗️ Architecture

Qubinode Navigator follows a container-first, plugin-based architecture:

• Core Framework (core/): Plugin manager, configuration, and event system
• OS Plugins (plugins/os/): Operating system-specific deployment logic
• Cloud Plugins (plugins/cloud/): Cloud provider integrations
• Environment Plugins (plugins/environments/): Deployment environment configurations

📚 Documentation

• Complete Documentation - Full documentation website
• Getting Started Guide - Quick start with AI orchestrator and non-root setup
• MCP Quick Start - Get started with MCP servers in 5 minutes
• MCP Implementation Guide - Complete FastMCP migration details
• Installation Guide - Step-by-step installation instructions
• User Guide - Practical how-to guides
• API Reference - Complete API documentation
• Architecture Overview - Technical architecture details
• Architecture Decision Records - Design decisions and rationale
• Developer Guide - Contributing guidelines

🧪 Testing

The project includes comprehensive testing:

# Run unit tests
python3 -m pytest tests/unit/

# Run integration tests
python3 -m pytest tests/integration/

# Test specific plugin
python3 -m pytest tests/unit/test_rhel10_plugin.py -v

🤝 Contributing

We welcome contributions! Please see our Developer's Guide for:

• Development setup
• Plugin development guidelines
• Testing requirements
• Code style standards

📄 License

This project is licensed under the terms specified in the LICENSE file.

🔗 Related Projects

• qubinode_kvmhost_setup_collection - Ansible collection for KVM host setup
• Ansible Navigator - Container-based Ansible execution