--planfile modeNote: If you use the
--planfileand--graphfileoptions to provide pre-generated Terraform outputs, Terraform itself does not need to be installed. Only Python, Graphviz, and Git are required. See the Usage Guide for details.
macOS:
brew install graphviz
Ubuntu/Debian:
sudo apt-get update
sudo apt-get install graphviz
Windows: Download from https://graphviz.org/download/
Verify installation:
dot -V
Most systems have Git pre-installed. Verify:
git --version
If not installed, download from https://git-scm.com/downloads
macOS:
brew tap hashicorp/tap
brew install hashicorp/terraform
Ubuntu/Debian:
wget -O- https://apt.releases.hashicorp.com/gpg | sudo gpg --dearmor -o /usr/share/keyrings/hashicorp-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/hashicorp-archive-keyring.gpg] https://apt.releases.hashicorp.com $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/hashicorp.list
sudo apt update && sudo apt install terraform
Windows: Download from https://developer.hashicorp.com/terraform/downloads
Verify installation:
terraform version
# Must show v1.0.0 or higher
This method installs packages globally and is suitable for casual users.
# Clone repository
git clone https://github.com/patrickchugh/terravision.git
cd terravision
# Install Python dependencies
pip install -r requirements.txt
# Make script executable
chmod +x terravision.py
# Create symbolic link
ln -s $(pwd)/terravision.py $(pwd)/terravision
# Add to PATH (add this to ~/.bashrc or ~/.zshrc for persistence)
export PATH=$PATH:$(pwd)
# Test installation
terravision --version
# Clone repository
git clone https://github.com/patrickchugh/terravision.git
cd terravision
# Install Python dependencies
pip install -r requirements.txt
# Create batch file wrapper
echo @python "%~dp0terravision.py" %* > terravision.bat
# Copy to system directory (requires admin privileges)
copy terravision.bat C:\Windows\System32\
# Test installation
terravision --version
This method uses Poetry for dependency management and is recommended for developers.
macOS/Linux:
curl -sSL https://install.python-poetry.org | python3 -
Windows:
(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py -
# Clone repository
git clone https://github.com/patrickchugh/terravision.git
cd terravision
# Install dependencies in virtual environment
poetry install
# Activate virtual environment
eval $(poetry env activate)
terravision
# Or use poetry run for individual commands
poetry run terravision --version
Run a test to ensure everything is working:
# Check TerraVision version
terravision --version
# Check help
terravision --help
# Verify all dependencies
terraform version
git --version
dot -V
python --version
If you want to use local AI-powered diagram refinement:
macOS:
brew install ollama
Linux:
curl -fsSL https://ollama.com/install.sh | sh
Windows: Download from https://ollama.com/download
# Start Ollama server (runs automatically on macOS/Linux after install)
ollama serve
# Pull the llama3 model
ollama pull llama3
# Optional: Keep model loaded longer (default is 5 minutes)
export OLLAMA_KEEP_ALIVE=1h
# Verify Ollama is running
curl http://localhost:11434/api/tags
# Check Python version
python --version
# If Python 3.10+ not available, install it
# macOS
brew install python@3.10
# Ubuntu
sudo apt-get install python3.10
# If pip install fails with permission errors, use --user flag
pip install --user -r requirements.txt
# Or use virtual environment
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
If terravision command is not found:
# Add to PATH temporarily
export PATH=$PATH:/path/to/terravision
# Add to PATH permanently (add to ~/.bashrc or ~/.zshrc)
echo 'export PATH=$PATH:/path/to/terravision' >> ~/.bashrc
source ~/.bashrc
If you get “dot command not found” error:
# Verify Graphviz installation
which dot
# If not found, reinstall Graphviz
# macOS
brew reinstall graphviz
# Ubuntu
sudo apt-get install --reinstall graphviz