Installation

Complete installation guide for building QBITEL Bridge from source across all four language stacks.

System Requirements

Resource Minimum Recommended
CPU 2 cores 4+ cores
RAM 4 GB 8 GB+
Storage 20 GB 50 GB+ SSD
OS Linux (Ubuntu 20.04+), macOS, Windows with WSL2
GPU Optional -- NVIDIA CUDA for AI model training

Software Prerequisites

Component Version Purpose
Python 3.10+ AI Engine, compliance, security
Rust 1.70+ (with cargo) Data plane, PQC-TLS
Go 1.21+ Control plane, management API
Node.js 18+ (with npm) UI console
Docker 20.10+ Container builds
Git 2.30+ Version control

Clone the Repository

git clone https://github.com/yazhsab/qbitel-bridge.git
cd qbitel-bridge

Build All Components

The unified Makefile builds everything in one command:

# Build all components
make build

# Run all tests
make test

Python AI Engine

The AI Engine is the core intelligence layer, built with Python, PyTorch, and FastAPI.

# Create and activate virtual environment
python3 -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# Install dependencies
pip install --upgrade pip
pip install -r requirements.txt

# Install pre-commit hooks
pre-commit install

# Verify installation
pytest ai_engine/tests/ -v --tb=short

# Start the engine
python -m ai_engine

Rust Data Plane

The data plane handles wire-speed packet processing with PQC-TLS.

# Build the data plane
cd rust/dataplane
cargo build --locked

# Run tests
cargo test

# Run linter
cargo clippy --all-targets --all-features -- -D warnings

# Format code
cargo fmt

Go Control Plane

The control plane orchestrates services and enforces policy with OPA.

# Build control plane
cd go/controlplane
go build -trimpath -o ../../dist/controlplane ./cmd/controlplane

# Build management API
cd go/mgmtapi
go build -trimpath -o ../../dist/mgmtapi ./cmd/mgmtapi

# Run tests
cd go/controlplane && go test ./...
cd go/mgmtapi && go test ./...

UI Console

The React-based admin console provides dashboards and management interfaces.

cd ui/console
npm install
npm run dev
# Console available at http://localhost:3000

Verify Installation

Run the full test suite to verify everything is installed correctly:

# Run all tests across all components
make test

# Or run each component's tests individually
pytest ai_engine/tests/ -v              # Python
cd rust/dataplane && cargo test         # Rust
cd go/controlplane && go test ./...     # Go
cd ui/console && npm test               # React

Next Steps