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

Agent Integration

Learn how to integrate ELIZAOS agents with your existing systems.

GPU Instances

Explore GPU instance options optimized for ELIZAOS workloads.

MCP Integration

Connect external data sources and tools to your ELIZAOS agents.