Skip to main content
Deploy ELIZAOS on Comput3 Network to start building and running multi-agent AI systems with distributed GPU computing power.

Deployment Options

Managed ELIZAOS

Recommended for most users
  • Pre-configured ELIZAOS environment
  • Automatic updates and maintenance
  • Integrated monitoring and logging
  • Enterprise support included

Self-Managed

For advanced customization
  • Full control over ELIZAOS configuration
  • Custom agent development environment
  • Direct GPU instance management
  • Flexible resource allocation

Quick Start: Managed ELIZAOS

1

Launch ELIZAOS Instance

Deploy a managed ELIZAOS environment from your Comput3 dashboard.
Best for: Getting started, small projects
  • GPU: RTX 4090 48GB or A100 40GB
  • RAM: 16GB
  • Storage: 100GB SSD
  • Cost: ~$1.20-2.50/hour
2

Access ELIZAOS Interface

Connect to your ELIZAOS deployment through the web interface.
# ELIZAOS web interface runs on port 3000
https://<your-instance-ip>:3000
The managed deployment automatically configures networking and security settings.
3

Create Your First Agent

Use the ELIZAOS interface to create and configure your first AI agent.
ELIZAOS agent creation interface showing configuration options
4

Deploy and Monitor

Deploy your agent and monitor its performance through the dashboard.
Your agent will start running immediately and appear in the active agents list.

Self-Managed Installation

Prerequisites

  • GPU instance with ELIZAOS template or manual setup capability
  • Basic knowledge of Docker and container orchestration
  • Understanding of AI agent concepts and workflows

Installation Process

1

Launch GPU Instance

Deploy a GPU instance suitable for ELIZAOS workloads.Recommended Specifications:
  • Minimum: RTX 4090 48GB with 16GB RAM
  • Recommended: A100 40GB with 32GB RAM
  • Optimal: A100 80GB, H100, H200, or B200 with 64GB+ RAM
2

Install ELIZAOS

Install ELIZAOS on your GPU instance.
# Pull ELIZAOS Docker image
docker pull elizaos/elizaos:latest

# Create ELIZAOS directory
mkdir -p /opt/elizaos
cd /opt/elizaos

# Download configuration template
wget https://raw.githubusercontent.com/elizaos/elizaos/main/docker-compose.yml

# Start ELIZAOS
docker-compose up -d
3

Configure Comput3 Integration

Connect ELIZAOS to Comput3 Network services.
{
  "comput3": {
    "api_key": "YOUR_COMPUT3_API_KEY",
    "base_url": "https://api.comput3.ai/v1",
    "default_model": "hermes4:70b",
    "gpu_instance_id": "i-1234567890abcdef0"
  }
}
4

Verify Installation

Test that ELIZAOS is running correctly and connected to Comput3.
# Check ELIZAOS status
curl http://localhost:3000/health

# Test Comput3 connection
curl http://localhost:3000/api/test-comput3

Configuration

Environment Configuration

Essential ELIZAOS settings
# .env file
ELIZAOS_PORT=3000
ELIZAOS_ENV=production
LOG_LEVEL=info

# Comput3 Integration
COMPUT3_API_KEY=your_api_key_here
COMPUT3_BASE_URL=https://api.comput3.ai/v1
COMPUT3_DEFAULT_MODEL=hermes4:70b

# Database
DATABASE_URL=postgresql://user:pass@localhost:5432/elizaos
REDIS_URL=redis://localhost:6379

# Security
JWT_SECRET=your_jwt_secret_here
ENCRYPTION_KEY=your_encryption_key_here
GPU resource allocation settings
{
  "gpu": {
    "enabled": true,
    "devices": ["0"],
    "memory_fraction": 0.8,
    "allow_growth": true
  },
  "agents": {
    "max_concurrent": 4,
    "default_gpu_memory": "4GB",
    "memory_limit": "8GB"
  }
}
Networking and communication settings
{
  "network": {
    "bind_address": "0.0.0.0",
    "port": 3000,
    "ssl_enabled": true,
    "cors_origins": ["https://app.comput3.ai"]
  },
  "communication": {
    "message_queue": "redis",
    "event_bus": "nats",
    "discovery_service": "consul"
  }
}

Agent Configuration Templates

{
  "name": "document-analyzer",
  "type": "task_agent",
  "config": {
    "model": "hermes4:70b",
    "max_tokens": 4096,
    "temperature": 0.3,
    "tools": ["file_reader", "text_analyzer"],
    "resources": {
      "gpu_memory": "2GB",
      "cpu_cores": 2,
      "ram": "4GB"
    }
  },
  "triggers": [
    {
      "type": "file_upload",
      "pattern": "*.pdf",
      "action": "analyze_document"
    }
  ]
}

Monitoring and Management

ELIZAOS Dashboard

ELIZAOS management dashboard showing active agents, resource usage, and system metrics
Dashboard Features:
  • Active Agents: Real-time status of all running agents
  • Resource Usage: GPU, CPU, and memory utilization
  • Performance Metrics: Agent efficiency and response times
  • Cost Tracking: Real-time cost monitoring and projections

Agent Lifecycle Management

Understanding agent lifecycle states
  • Created: Agent configured but not deployed
  • Starting: Agent initialization in progress
  • Running: Agent actively processing tasks
  • Paused: Agent temporarily suspended
  • Stopped: Agent terminated but configuration preserved
  • Failed: Agent encountered unrecoverable error

Troubleshooting

Common installation problemsGPU Driver Issues:
# Check GPU status
nvidia-smi

# Reinstall NVIDIA drivers if needed
sudo apt update
sudo apt install nvidia-driver-525
sudo reboot
Docker Issues:
# Check Docker status
docker version

# Install Docker if missing
curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh

# Add user to docker group
sudo usermod -aG docker $USER
Agents failing to start or crashingCommon Causes:
  • Insufficient GPU memory allocation
  • Model loading failures
  • Configuration syntax errors
  • Network connectivity issues
Debugging Steps:
# Check agent logs
elizaos agent logs <agent-name> --level debug

# Verify configuration
elizaos config validate <agent-config.json>

# Test model connectivity
elizaos test model hermes4:70b

# Check resource availability
elizaos system resources
Slow agent response or high resource usageOptimization Strategies:
  • Adjust agent resource allocations
  • Optimize model parameters (temperature, max_tokens)
  • Implement request batching
  • Use agent specialization to reduce model switching
  • Monitor and tune GPU memory usage

Security Configuration

Access Controls

Authentication

Secure access to ELIZAOS interface
  • JWT-based authentication
  • OAuth integration support
  • Multi-factor authentication
  • Session management and timeouts

Authorization

Role-based access control
  • Admin, developer, and viewer roles
  • Agent-specific permissions
  • Resource access controls
  • Audit logging for all actions

Network Security

Secure communications
{
  "tls": {
    "enabled": true,
    "cert_file": "/etc/ssl/certs/elizaos.crt",
    "key_file": "/etc/ssl/private/elizaos.key",
    "min_version": "1.3"
  }
}
Network access controls
# Allow ELIZAOS web interface
sudo ufw allow 3000/tcp

# Allow agent communication ports
sudo ufw allow 8000:8100/tcp

# Allow SSH for management
sudo ufw allow 22/tcp

# Enable firewall
sudo ufw enable
Secure agent execution environment
  • Process isolation between agents
  • Network namespace separation
  • Resource quota enforcement
  • Secure inter-agent communication

Performance Optimization

Resource Allocation

Maximize GPU utilization
{
  "gpu_config": {
    "memory_pool": "dynamic",
    "sharing_strategy": "time_slicing",
    "max_agents_per_gpu": 4,
    "memory_reservation": "2GB"
  }
}

Scaling Strategies

Scale up individual instances
  • Upgrade to more powerful GPU instances
  • Increase RAM and storage allocation
  • Optimize agent resource distribution
  • Monitor performance metrics for scaling decisions
Scale out across multiple instances
# Kubernetes scaling configuration
apiVersion: autoscaling/v2
kind: HorizontalPodAutoscaler
metadata:
  name: elizaos-hpa
spec:
  scaleTargetRef:
    apiVersion: apps/v1
    kind: Deployment
    name: elizaos
  minReplicas: 1
  maxReplicas: 10
  metrics:
  - type: Resource
    resource:
      name: cpu
      target:
        type: Utilization
        averageUtilization: 70
Automatic resource adjustment
  • Agent-based scaling triggers
  • Resource utilization monitoring
  • Cost-aware scaling decisions
  • Predictive scaling based on usage patterns

Backup and Recovery

Data Backup

1

Agent Configurations

Backup agent definitions and configurations
# Export all agent configurations
elizaos export agents --output /backup/agents.json

# Export system configuration
elizaos export config --output /backup/elizaos-config.json
2

Agent State

Backup agent memory and state
# Create agent state snapshot
elizaos snapshot create --agent document-analyzer

# List available snapshots
elizaos snapshot list

# Export snapshots to storage
elizaos snapshot export --destination s3://backups/elizaos/
3

System Data

Backup logs, metrics, and system data
# Archive logs
tar -czf /backup/logs.tar.gz /var/log/elizaos/

# Export metrics database
pg_dump elizaos_metrics > /backup/metrics.sql

# Sync to cloud storage
aws s3 sync /backup/ s3://elizaos-backups/$(date +%Y%m%d)/

Disaster Recovery

Prepare for system failures
  • Document recovery procedures
  • Test backup restoration regularly
  • Maintain off-site backup copies
  • Plan for different failure scenarios
Rapid system restoration
# Restore from backup
elizaos restore --backup-file /backup/elizaos-backup.tar.gz

# Restart all agents
elizaos agent start-all

# Verify system health
elizaos system health-check

Integration with Comput3 Services

API Integration

import elizaos
from comput3 import Comput3Client

# Initialize ELIZAOS client
elizaos_client = elizaos.Client(
    base_url="http://localhost:3000",
    api_key="your-elizaos-api-key"
)

# Initialize Comput3 client  
comput3_client = Comput3Client(
    api_key="your-comput3-api-key",
    base_url="https://api.comput3.ai/v1"
)

# Create agent with Comput3 integration
agent_config = {
    "name": "data-processor",
    "model": "hermes4:70b",
    "comput3_integration": {
        "client": comput3_client,
        "auto_scale": True,
        "cost_limit": 100  # USD per day
    }
}

agent = elizaos_client.create_agent(agent_config)

Next Steps