Architect

AIVory Architect for JetBrains

Visual cloud infrastructure design directly in IntelliJ IDEA, WebStorm, PyCharm, and all JetBrains IDEs.

Visual Designer with drag-and-drop canvas and multi-cloud support
One-click Terraform generation with production-ready code
Integrated Deployment with terraform init/plan/apply from IDE
Kubernetes Management with pod status monitoring and SSH access
Secure Vault for encrypted credential storage

Installation

From JetBrains Marketplace

Open your JetBrains IDE
Go to Settings → Plugins → Marketplace
Search for “AIVory Architect”
Click Install and restart your IDE

Or install directly: JetBrains Marketplace

Note The plugin auto-updates when new versions are available. Enable automatic updates in Settings → Plugins to stay current.

Manual Installation

If you prefer to install manually or need an older version:

Download the plugin from JetBrains Marketplace
Go to Settings → Plugins → ⚙️ → Install Plugin from Disk
Select the downloaded .zip file
Restart your IDE

Requirements

IntelliJ IDEA 2023.3+

Community or Ultimate edition

Java 17+

JetBrains Runtime recommended

Terraform 1.6+

For deployment features

kubectl

For Kubernetes features

Getting Started

Open the AIVory Architect tool window from the right sidebar
Drag resources from the palette onto the canvas
Connect resources to define dependencies
Edit properties in the side panel
Click Generate Terraform to create deployment files
Click Deploy to provision your infrastructure

Note The designer auto-saves your work. You can close and reopen the tool window without losing progress.

Features

Visual Infrastructure Designer

Drag-and-Drop Canvas

Grid snapping and zoom/pan controls

Resource Palette

VMs, databases, load balancers, networks, storage, GPU instances

Multi-Cloud Support

AWS, Azure, GCP, Hetzner, RunPod, DeepInfra, Cloudflare

Property Panels

Validation and cloud-specific configuration

Visual Dependencies

Connect nodes to define relationships

Auto-Save

Designs saved with full serialization

Terraform Code Generation

One-click generation of production-ready main.tf, variables.tf, outputs.tf
Provider-specific templates with proper resource naming
Automatic dependency resolution and topological sorting
Diff viewer shows changes before overwriting existing files
Variables extraction for secrets and configuration

Note Use the diff viewer to review changes before overwriting existing Terraform files. This prevents accidental loss of manual customizations.

Integrated Deployment

Execute terraform init, plan, apply directly from IDE
Real-time progress indicators with streaming output
Plan preview before deploying changes
State file parsing for deployed resource tracking
Cancellable operations with proper cleanup

Kubernetes Management

Direct Deploy

Deploy manifests from designer to K8s clusters

Pod Assignment

Visually map pods to VMs

Status Monitoring

Real-time pod status with color-coded health

SSH/Exec

Shell into running containers

Namespace Management

Manage namespaces and contexts

Vault & Environment Management

Secure credential storage with AES-256-GCM encryption
Environment variable management per deployment
Firewall rule configuration with visual connections
Export configurations for team collaboration

Note Credentials are stored locally with strong encryption. They never leave your machine unless you explicitly export them.

Authentication

For cloud sync and team features:

Click Sign In in the tool window
Browser opens to https://auth.aivory.net
Authenticate with your account
Return to IDE - you’re signed in!

Note If you have AIVory Guard installed, authentication is shared between both plugins. Sign in once, use both products.

File-Based Configuration

AIVory Architect automatically detects and parses project files:

File	Purpose
`.env`	Environment variables and cloud credentials
`terraform.tfvars`	Terraform variable values
*`.tf`**	Existing Terraform resource definitions
`terraform.tfstate`	Deployed resource state
*`.yaml`**	Kubernetes manifests
`docker-compose.yml`	Docker Compose stacks

Supported Environment Variables

Configure cloud credentials in your .env file:

# Cloud Providers
HCLOUD_TOKEN=...
AWS_ACCESS_KEY_ID=...
AWS_SECRET_ACCESS_KEY=...
AZURE_SUBSCRIPTION_ID=...
AZURE_CLIENT_ID=...
GOOGLE_APPLICATION_CREDENTIALS=...
RUNPOD_API_KEY=...
DEEPINFRA_API_TOKEN=...
CLOUDFLARE_API_TOKEN=...

# Kubernetes
KUBECONFIG=/path/to/kubeconfig

Troubleshooting

Plugin Not Loading

Check IDE version (requires 2023.3+)
Verify Java version (requires 17+)
Check Help → Show Log in Explorer/Finder for errors
Try invalidating caches: File → Invalidate Caches

Authentication Failed

Verify port 39999 is not in use by another application
Check firewall/antivirus settings
Try Sign Out → Sign In again
Clear browser cookies for auth.aivory.net

Terraform Not Found

Verify Terraform is installed: terraform --version
Add Terraform to your PATH environment variable
Or specify the full path in plugin settings: Settings → Tools → AIVory Architect

Warning If you encounter persistent issues, check the IDE log files at Help → Show Log in Explorer/Finder and include them when contacting support.