Proxmox VE Heretek-Scripts

A Heretek Forge of Proxmox VE Scripts

Experimental scripts beyond the orthodox canon

Experimental AI/ML and specialized scripts for Proxmox VE
Originally created by tteck, maintained by the community, extended by hereteks

---

⚙️ The Heretek's Forge

"The Omnissiah guides our scripts, but innovation demands we venture beyond established doctrine."

While the orthodox community-scripts/ProxmoxVE maintains the sacred canon of stable, community-vetted scripts, this Heretek repository serves as a forge for experimental and specialized tools that may one day prove worthy of the main temple.

What makes this a Heretek forge:

• 🧪 Experimental AI/ML Scripts — Cutting-edge AI tooling before mainstream adoption
• 🔧 Niche Applications — Specialized tools for specific use cases
• ⚡ Rapid Iteration — Faster release cycles for emerging technologies
• 🔄 Upstream Path — Successful scripts may ascend to the orthodox repository

---

🏛️ Relationship to the Orthodox Repository

This fork maintains synchronization with community-scripts/ProxmoxVE while adding experimental scripts that may not yet meet the stability requirements for upstream inclusion.

Aspect	Orthodox (Upstream)	Heretek (This Fork)
Stability	Production-ready	Experimental/Bleeding-edge
Focus	Broad community needs	AI/ML & specialized tools
Release Cycle	Stable & tested	Rapid iteration
Best For	General users	Early adopters

Scripts that prove stable and gain community interest may be submitted upstream to join the orthodox canon.

---

🧪 Heretek Scripts

These scripts are exclusive to this forge, focusing on AI/ML workloads and specialized applications:

AI & Machine Learning

Script	Description	Resources
MCPHub	Model Context Protocol Hub for AI tooling integration	2 CPU / 2GB RAM
Hermes	Nous Research Hermes AI Agent	8 CPU / 16GB RAM
Lemonade	Local AI inference server with GPU support	2 CPU / 4GB RAM + GPU
SwarmUI	Stable Diffusion Swarm interface	8 CPU / 16GB RAM + GPU
LlamaCPP	High-performance LLM inference engine with GPU acceleration	4 CPU / 8GB RAM + GPU
OpenClaw	AI-powered assistant and automation platform	2 CPU / 4GB RAM

Media & Gaming

Script	Description	Resources
Agregarr	Media aggregation and streaming	2 CPU / 4GB RAM
Drop	Gaming and media server	2 CPU / 4GB RAM
Maintainerr	Media library management for Plex/Jellyfin/Emby	2 CPU / 4GB RAM

Productivity & Tools

Script	Description	Resources
Wakapi	Self-hosted coding time tracking and analytics	2 CPU / 2GB RAM
PegaProx	Proxmox cluster management and monitoring	2 CPU / 2GB RAM

---

🖥️ Virtual Machine Scripts

Complete VM deployment scripts for various operating systems and specialized appliances:

Operating Systems

Script	Description
Arch Linux VM	Arch Linux virtual machine
Debian 12 VM	Debian 12 (Bookworm) virtual machine
Debian 13 VM	Debian 13 (Trixie) virtual machine
Ubuntu 22.04 VM	Ubuntu 22.04 LTS (Jammy Jellyfish) virtual machine
Ubuntu 24.04 VM	Ubuntu 24.04 LTS (Noble Numbat) virtual machine
Ubuntu 25.04 VM	Ubuntu 25.04 (Plucky Puffin) virtual machine

Network & Security

Script	Description
OPNsense VM	OPNsense firewall and router
OpenWrt VM	OpenWrt wireless router platform
MikroTik RouterOS VM	MikroTik RouterOS virtual router

Storage & Cloud

Script	Description
TrueNAS VM	TrueNAS Community Edition storage server
Nextcloud VM	Nextcloud self-hosted cloud platform
ownCloud VM	ownCloud file sync and share platform
Olares VM	Olares personal cloud OS with AI capabilities
Umbrel OS VM	Umbrel personal server OS

Home Automation & Docker

Script	Description
Home Assistant OS VM	Home Assistant Operating System
Pimox HAOS VM	Home Assistant OS for Raspberry Pi (Pimox)
Docker VM	Docker-ready virtual machine

⚠️ Note: Heretek scripts may require more resources or additional configuration. Check individual script documentation for requirements.

---

🎯 Key Features

⚡ Quick Setup One-command installations for popular services and containers	⚙️ Flexible Config Simple mode for beginners, advanced options for power users	🔄 Auto Updates Keep your installations current with built-in update mechanisms	🛠️ Easy Management Post-install scripts for configuration and troubleshooting
👥 Community Driven Actively maintained with contributions from users worldwide	📖 Well Documented Comprehensive guides and community support	🔒 Secure Regular security updates and best practices	⚡ Performance Optimized configurations for best performance

---

📋 Requirements

🖥️ Proxmox VE Version: 8.4.x | 9.0.x | 9.1.x

🐧 Operating System Debian-based with Proxmox Tools

🌐 Network Internet connection required

---

📥 Getting Started

Choose your preferred installation method:

Method 1: One-Click Web Installer

The fastest way to get started:

1. Visit helpful-scripts.com 🌐
2. Search for your desired script (e.g., "MCPHub", "Hermes", "Lemonade")
3. Copy the bash command displayed on the script page
4. Open your Proxmox Shell and paste the command
5. Press Enter and follow the interactive prompts

Method 2: Direct Script Execution

For Heretek scripts, use the Heretek-AI repository:

# Example: Install MCPHub
bash -c "$(curl -fsSL https://raw.githubusercontent.com/Heretek-AI/ProxmoxVE/main/ct/mcphub.sh)"

Method 3: PVEScripts-Local

Install a convenient script manager directly in your Proxmox UI:

bash -c "$(curl -fsSL https://raw.githubusercontent.com/Heretek-AI/ProxmoxVE/main/ct/pve-scripts-local.sh)"

This adds a menu to your Proxmox interface for easy script access without visiting the website.

📖 Learn more: ProxmoxVE-Local Repository

---

💬 Join the Community

💬 Discord Real-time chat, support, and discussions

💭 Discussions Feature requests, Q&A, and ideas

🐛 Issues Bug reports and issue tracking

---

🛠️ Contribute

💻 Code Add new scripts or improve existing ones

📝 Documentation Write guides, improve READMEs, translate content

🧪 Testing Test scripts and report compatibility issues

💡 Ideas Suggest features or workflow improvements

👉 Check our Contributing Guidelines to get started

---

❤️ Support the Project

This project is maintained by volunteers in memory of tteck. Your support helps us maintain infrastructure, improve documentation, and give back to important causes.

🎗️ 30% of all donations go directly to cancer research and hospice care

_{Every contribution helps keep this project alive and supports meaningful causes}

---

📈 Project Statistics

---

📜 License

This project is licensed under the MIT License — feel free to use, modify, and distribute.

---

_{Forged with ⚙️ by the Heretek community
In memory of tteck, whose scripts lit the way
Proxmox® is a registered trademark of Proxmox Server Solutions GmbH}