AIVory Architect - Visual Cloud Infrastructure Designer for VS Code
Design cloud infrastructure visually, generate production-ready Terraform, and deploy with one click. AWS, Azure, GCP, Hetzner, RunPod, DeepInfra & Cloudflare.
Features
Visual Infrastructure Designer
- Drag-and-drop canvas with grid snapping and zoom/pan
- Resource palette: VMs, databases, load balancers, networks, storage, GPU instances
- Multi-cloud support: AWS, Azure, GCP, Hetzner Cloud, RunPod, DeepInfra, Cloudflare
- Property panels with validation and cloud-specific configuration
- Connect nodes to define dependencies visually
- Auto-save designs with full serialization
- 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
Integrated Deployment
- Execute
terraform init, plan, apply directly from VS Code
- 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
- Deploy manifests directly from designer to K8s clusters
- Pod assignment to VMs with visual mapping
- Real-time pod status monitoring with color-coded health
- SSH/exec into running containers
- Namespace and context management
Credential 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
Installation
From VS Code Marketplace
- Open VS Code
- Go to Extensions (
Ctrl+Shift+X / Cmd+Shift+X)
- Search for "AIVory Architect"
- Click Install
From VSIX
code --install-extension aivory-architect-X.Y.Z.vsix
Quick Start
1. Open a Project
Open any workspace - AIVory Architect will detect existing .env, .tf, and terraform.tfstate files.
2. Open the Designer
- Click the AIVory Architect icon in the Activity Bar (left sidebar)
- Click Open Designer in the sidebar panel
3. Design Your Infrastructure
- Drag resources from the Cloud Provider palette onto the canvas
- Click resources to edit their Properties
- Connect resources to define dependencies
- Assign Kubernetes pods to VMs in the Pod Assignment panel
- Click Generate Terraform in the toolbar
- Review generated files in the diff viewer
- Files are saved to your project's
.aivory/ directory
5. Deploy
- Click Deploy to run
terraform apply
- Monitor progress in the integrated terminal
- View deployed resources in real-time
Authentication (Optional - For Premium Features)
Sign In
- Click Sign In in the sidebar panel
- Browser opens to
https://auth.aivory.net
- Authenticate with your account
- Return to VS Code - you're signed in!
Cloud Providers
| Provider |
Status |
Resources Supported |
| Hetzner Cloud |
Full Support |
Servers, Volumes, Networks, Load Balancers, Firewalls |
| AWS |
Available |
EC2, RDS, ELB, VPC, EBS, S3 |
| Azure |
Available |
VMs, SQL Database, Load Balancer, VNet, Managed Disks |
| GCP |
Available |
Compute Engine, Cloud SQL, Load Balancing, VPC |
| RunPod |
Available |
GPU Instances, Serverless Endpoints |
| DeepInfra |
Available |
AI Model Endpoints, Inference APIs |
| Cloudflare |
Available |
DNS, Workers, R2 Storage |
Configuration
Access settings: File � Preferences � Settings � Search for "Architect"
Key Settings
| Setting |
Default |
Description |
architect.terraformPath |
"" |
Path to terraform binary (uses PATH if empty) |
architect.kubectlPath |
"" |
Path to kubectl binary (uses PATH if empty) |
architect.dockerPath |
"" |
Path to docker binary (uses PATH if empty) |
architect.defaultEnvironment |
dev |
Default environment (dev/staging/production) |
architect.autoRefreshInterval |
30 |
Auto-refresh interval in seconds |
architect.enableFileWatcher |
true |
Watch .env, .tf, .yaml files for changes |
architect.gridSize |
20 |
Designer canvas grid size for snapping |
Commands
| Command |
Description |
Architect: Show Panel |
Open the main designer panel |
Architect: Sign In |
Authenticate with browser OAuth2 |
Architect: Sign Out |
Clear authentication tokens |
Architect: Terraform Init |
Initialize Terraform in workspace |
Architect: Terraform Plan |
Preview infrastructure changes |
Architect: Terraform Apply |
Apply infrastructure changes |
Architect: Deploy Infrastructure |
Full deployment workflow |
Architect: New Design |
Create a new infrastructure design |
Architect: Save Design |
Save current design |
Architect: Load Design |
Load an existing design |
Architect: Export to Terraform |
Generate Terraform files |
Architect: Refresh |
Refresh infrastructure state |
File-Based Configuration
AIVory Architect automatically detects and parses:
.env - Environment variables and cloud credentialsterraform.tfvars - Terraform variable values*.tf - Terraform resource definitionsterraform.tfstate - Deployed resource state*.yaml - Kubernetes manifestsdocker-compose.yml - Docker Compose stacks
Supported Environment Variables
# 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
License Tiers
Free Tier
- Visual infrastructure designer (view mode)
- Cloud provider palette and property panels
- Design save/load functionality
Trial / Licensed
- Deploy infrastructure directly from IDE
- Terraform export and code generation
- Credential vault with encryption
- Pod assignment and Kubernetes management
- Real-time monitoring and SSH access
View Plans
Requirements
- VS Code 1.85+
- Terraform 1.6+ (for deployment features)
- kubectl (for Kubernetes features)
- Docker (for container features)
Troubleshooting
Extension Not Loading
- Check VS Code version (requires 1.85+)
- Reload window: Developer: Reload Window
- Check console: Help � Toggle Developer Tools
Authentication Failed
- Verify port 39999 is not in use
- Check firewall/antivirus settings
- Try again: Sign Out � Sign In
- Verify Terraform is installed:
terraform --version
- Set explicit path in settings:
architect.terraformPath
Designer Not Rendering
- Reload the panel: Close and reopen
- Check for JavaScript errors in Developer Tools
Support
License
Proprietary - see LICENSE file for details.
Made with ❤️ by the AIVory Team
Website | Documentation
| |
