A tool for creating and managing GPU-ready Cloud test environments.

• Quick Start
• Prerequisites
• Commands Reference
• Contributing Guide
• Examples
• Latest Release

• Multi-OS Support: Ubuntu, Rocky Linux 9, Amazon Linux 2023 with automatic AMI resolution (guide)
• Multi-Architecture: x86_64 and ARM64 with automatic architecture inference
• Custom Templates: Run user-provided scripts at any provisioning phase (guide)
• Multi-Node Clusters: HA Kubernetes clusters with kubeadm (guide)
• Flexible Sources: Install components from packages, git, runfiles, or latest branches (guide)
• Automatic IP Detection: No manual IP configuration needed for AWS (guide)

See docs/quick-start.md for a full walkthrough.

make build
sudo mv ./bin/holodeck /usr/local/bin/holodeck
holodeck --help

• Go 1.20+
• (For AWS) Valid AWS credentials in your environment
• (For SSH) Reachable host and valid SSH key

See docs/prerequisites.md for details.

When installing NVIDIA drivers, Holodeck requires kernel headers matching your running kernel version. If exact headers are unavailable, Holodeck will attempt to find compatible ones, though this may cause driver compilation issues.

For kernel compatibility details and troubleshooting, see Kernel Compatibility in the prerequisites documentation.

See docs/contributing/ for full details.

• make build – Build the holodeck binary
• make test – Run all tests
• make lint – Run linters
• make clean – Remove build artifacts

See docs/commands/ for detailed command documentation and examples.

holodeck --help

holodeck create -f ./examples/v1alpha1_environment.yaml

holodeck list

holodeck delete <instance-id>

holodeck cleanup vpc-12345678

holodeck status <instance-id>

holodeck dryrun -f ./examples/v1alpha1_environment.yaml

• Examples
• Guides

For more information, see the documentation directory.