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

---

📌 About This Repository

This is a standalone mirror of Heretek-AI/ProxmoxVE

All development and changes happen on the main ProxmoxVE repository and are automatically synced here. This repository serves as a standalone copy for those who want to reference or clone the Heretek scripts independently.

Repository	Purpose
Heretek-AI/ProxmoxVE	Main development repository where all changes are made
Heretek-AI/Heretek-ProxmoxVE	Standalone mirror (this repo) - synced from ProxmoxVE

---

⚙️ 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
Hermes	Self-improving AI agent with built-in learning loop. Creates skills from experience and builds user preference models across sessions	8 CPU / 16GB RAM
Lemonade	Lightweight LLM inference server with OpenAI-compatible APIs. Supports CPU, Vulkan, and ROCm backends	2 CPU / 4GB RAM
llama.cpp Server	High-performance LLM inference server with OpenAI-compatible API using Vulkan backend for GPU acceleration	4 CPU / 8GB RAM + GPU
MCPHub	Unified hub for centrally managing and routing multiple MCP servers through a single dashboard and API	2 CPU / 2GB RAM
OpenClaw	Personal AI assistant supporting WhatsApp, Telegram, Slack, Discord, Signal, iMessage, IRC, Teams, Matrix and more	2 CPU / 4GB RAM
SwarmUI	Powerful Stable Diffusion WebUI with built-in ComfyUI integration for AI image generation	8 CPU / 16GB RAM + GPU

Proxmox & Virtualization

Script	Description	Resources
PegaProx	Web-based management interface for Proxmox VE and XCP-ng clusters with live monitoring, VM management, and cross-cluster migrations	2 CPU / 2GB RAM
Olares	Open-source personal cloud OS for self-hosting AI models, applications, and data with enterprise-grade security (VM)	4 CPU / 8GB RAM / 160GB SSD
OSX-Proxmox-Next	Automated macOS VM creation for Proxmox VE. Supports Ventura 13, Sonoma 14, Sequoia 15, and Tahoe 26 (Tool)	Varies

Media & Streaming

Script	Description	Resources
Agregarr	Keeps Plex Home and Recommended fresh with Collections from Trakt, IMDb, TMDB, Letterboxd, MDBList, FlixPatrol, AniList and MyAnimeList	2 CPU / 4GB RAM
Maintainerr	Automatically manage media collections in Plex, Jellyfin, and Emby by syncing with Radarr and Sonarr	2 CPU / 4GB RAM

Gaming & Leisure

Script	Description	Resources
Drop	Open-source game distribution platform similar to Steam/GameVault. Manage game library, track playtime, and organize collections	2 CPU / 4GB RAM

Developer Tools

Script	Description	Resources
Wakapi	Minimalist, self-hosted WakaTime-compatible backend for coding statistics. Track coding time across projects, languages, and editors	2 CPU / 2GB RAM

Addons

Script	Description	Requirements
AMD ROCm	AMD GPU programming stack for high-performance computing and machine learning. Execute within existing LXC	GPU passthrough required

⚠️ 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}