What is WezzelOS Forge?
WezzelOS Forge Full Edition is a Debian-based live operating system pre-configured for AI-assisted infrastructure management, VM orchestration, and development workflows. It boots from USB or ISO and runs entirely in RAM, leaving the host system untouched.
Build Statistics
Features
CICERONE
AI Admin VM Management System. Natural language interface for infrastructure automation. SSH-based remote administration with LLM-powered decision making.
vimic2
CI/CD Orchestration Platform. QEMU backing files, Open vSwitch networking, multi-platform runners. Pre-configured with systemd service.
XFCE Desktop
Lightweight desktop environment with Firefox, LibreOffice, and essential tools. Remote desktop via RDP on port 3389.
Developer Tools
Pre-installed: git, vim, Go, Python 3, Node.js, Docker, kubectl, helm. Ready for development work.
Live Boot
Runs entirely in RAM. No installation required. Perfect for testing, recovery, and portable environments.
Pre-configured
All services pre-installed and configured. Just boot and use. Default credentials provided for quick start.
Pre-installed Components
CICERONE
AI Admin VM Management wrapper
/opt/cicerone/bin/cicerone
vimic2
CI/CD Orchestration binary
/opt/cicerone/bin/vimic2
vimic2 Config
Default configuration file
/opt/vimic2/config/vimic2.yaml
vimic2 Service
Systemd auto-start service
/etc/systemd/system/vimic2.service
Docker
Container runtime
/usr/bin/docker
kubectl & helm
Kubernetes tools
/usr/bin/kubectl
Go 1.x
Golang compiler
/usr/bin/go
Python 3
Python with pip & venv
/usr/bin/python3
System Requirements
| Component | Minimum | Recommended |
|---|---|---|
| RAM | 4 GB | 8+ GB |
| CPU | 2 cores | 4+ cores |
| Disk (for VMs) | 20 GB | 100+ GB |
| Boot Media | 1 GB USB | 8+ GB USB |
| Network | DHCP | Static IP |
| Virtualization | QEMU/KVM | Hardware virt support |
Quick Start
Boot the ISO
# Write to USB (Linux/macOS)
$ sudo dd if=wezzelos-forge-full-amd64.iso of=/dev/sdX bs=4M status=progress conv=fsync
# Or test in QEMU
$ qemu-system-x86_64 -m 8G -cdrom wezzelos-forge-full-amd64.iso -enable-kvm
Login Credentials
SSH Access:
$ ssh wezzelos@<IP_ADDRESS>
Password: wezzelos
Remote Desktop (RDP):
Address: <IP_ADDRESS>:3389
Username: wezzelos
Password: wezzelos
Using CICERONE
# Show CICERONE info
$ cicerone about
# Run health check
$ cicerone check
# Execute agentic command
$ cicerone do "create a VM with 4GB RAM"
Using vimic2
# Show help
$ vimic2 --help
# Start the server
$ vimic2 server
# Enable systemd service
$ sudo systemctl enable --now vimic2
Architecture
WezzelOS Forge Full is built on top of WezzelOS Desktop with additional components:
Layer Stack
┌─────────────────────────────────────────────────────────────┐
│ WezzelOS Forge Full │
├─────────────────────────────────────────────────────────────┤
│ CICERONE (AI Admin) │ vimic2 (CI/CD Orchestration) │
│ - Natural language IF │ - QEMU backing files │
│ - SSH remote admin │ - Open vSwitch networking │
│ - LLM integration │ - Multi-platform runners │
├─────────────────────────────────────────────────────────────┤
│ Development Tools │
│ Docker | kubectl | helm | Go | Python | Node.js | Git │
├─────────────────────────────────────────────────────────────┤
│ XFCE Desktop │
│ Firefox | LibreOffice | Terminal | Network Tools │
├─────────────────────────────────────────────────────────────┤
│ Debian Base │
│ Linux 6.1 LTS | systemd | apt | networking │
└─────────────────────────────────────────────────────────────┘
Download
Forge Full Edition
Complete edition with CICERONE, vimic2, and all development tools.
Size: 571 MB
Download ISOForge Desktop Edition
Desktop-only edition without CICERONE/vimic2. Smaller footprint.
Size: ~1 GB
Download ISO