Skip to content

Heretek-AI/ProxmoxVE

ย 
ย 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

15,656 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Proxmox VE Helper-Scripts Logo

Proxmox VE Heretek-Scripts

A Heretek Forge of Proxmox VE Scripts

Experimental scripts beyond the orthodox canon

Repository Upstream Discord

Contribute Guides Changelog


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

Discord

๐Ÿ’ญ Discussions

Feature requests, Q&A, and ideas

Discussions

๐Ÿ› Issues

Bug reports and issue tracking

Issues

๐Ÿ› ๏ธ 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

Support on Ko-fi
Every contribution helps keep this project alive and supports meaningful causes

๐Ÿ“ˆ Project Statistics

Repobeats analytics

Star History Chart


๐Ÿ“œ 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