Skip to main content

System Requirements

System Requirements

Separation of Duties: See Separation of Duties - Getting started guides document onboarding. They do NOT own agent manifests, execution, or infrastructure configuration.

BlueFly.io Agent Platform - Hardware, Software, and Prerequisites

Version: 1.0.0
Last Updated: 2025-12-02

Overview

This page outlines the system requirements for developing, deploying, and operating the BlueFly.io Agent Platform across different environments.

Development Environment

Hardware Requirements

Minimum:

  • CPU: 4 cores (Intel i5 or equivalent)
  • RAM: 16 GB
  • Storage: 50 GB SSD
  • Network: Broadband internet (10 Mbps+)

Recommended:

  • CPU: 8+ cores (Intel i7/i9, Apple M1/M2, AMD Ryzen 7+)
  • RAM: 32 GB
  • Storage: 256 GB NVMe SSD
  • Network: High-speed internet (100 Mbps+)

Optimal (for ML workloads):

  • CPU: 16+ cores
  • RAM: 64 GB
  • GPU: NVIDIA RTX 3090/4090 or Apple M2 Max/Ultra
  • Storage: 1 TB NVMe SSD
  • Network: Gigabit ethernet

Operating Systems

Supported:

  • macOS 13+ (Ventura, Sonoma, Sequoia)
  • Ubuntu 22.04 LTS or 24.04 LTS
  • Debian 12+
  • Fedora 38+

Not Supported:

  • Windows (use WSL2 with Ubuntu)
  • CentOS (EOL)
  • Older macOS versions (<13)

Software Prerequisites

Required

Node.js:

# Version 20.x LTS (required)
node --version  # Should show v20.x.x
npm --version   # Should show 10.x.x

Git:

# Version 2.40+
git --version  # Should show 2.40+

Docker:

# Version 24.0+
docker --version  # Should show 24.0+
docker compose version  # Should show 2.20+

Kubernetes CLI:

# kubectl 1.28+
kubectl version --client

Optional but Recommended

GitLab CLI:

# glab 1.40+
brew install glab
glab version

Helm:

# Helm 3.12+
brew install helm
helm version

DDEV:

# DDEV 1.22+
brew install ddev/ddev/ddev
ddev version

Terraform:

# Terraform 1.6+
brew install terraform
terraform version

Production Environment

Kubernetes Cluster

Minimum:

  • Kubernetes 1.28+
  • 3 worker nodes
  • 4 CPU, 16 GB RAM per node
  • 100 GB storage per node
  • CNI plugin (Calico, Cilium, or Flannel)
  • Ingress controller (NGINX or Traefik)

Recommended:

  • Kubernetes 1.29+
  • 5+ worker nodes
  • 8 CPU, 32 GB RAM per node
  • 500 GB NVMe storage per node
  • Cilium CNI with eBPF
  • NGINX Ingress with cert-manager
  • Persistent volume provisioner

Cloud Providers:

  • AWS EKS 1.28+
  • Google GKE 1.28+
  • Azure AKS 1.28+
  • DigitalOcean DOKS 1.28+

Database Requirements

PostgreSQL:

  • Version: 15+ (16 recommended)
  • RAM: 8 GB minimum
  • Storage: 100 GB SSD minimum
  • Connections: 200+ concurrent

Redis:

  • Version: 7.0+
  • RAM: 4 GB minimum
  • Persistence: AOF + RDB
  • Clustering: Recommended for production

Vector Database (Optional):

  • Pinecone (managed)
  • Weaviate 1.24+
  • Qdrant 1.7+
  • Milvus 2.3+

Storage Requirements

Persistent Volumes:

  • Database: 100 GB minimum
  • Logs: 50 GB minimum
  • Artifacts: 100 GB minimum
  • Backups: 200 GB minimum

Object Storage (S3-compatible):

  • AWS S3
  • MinIO
  • DigitalOcean Spaces
  • Cloudflare R2

Network Requirements

Ports

Required Open Ports:

PortServiceProtocol
80HTTPTCP
443HTTPSTCP
5432PostgreSQLTCP
6379RedisTCP
9090PrometheusTCP
3000GrafanaTCP
16686Jaeger UITCP
4317OTLP gRPCTCP
4318OTLP HTTPTCP

Firewall Rules

Ingress:

  • Allow 80/443 from internet (for web traffic)
  • Allow 22 from bastion/VPN (for SSH)
  • Allow 6443 from operators (for kubectl)

Egress:

  • Allow 443 to internet (for API calls, package downloads)
  • Allow 5432 to database (if external)
  • Allow 6379 to Redis (if external)

DNS Requirements

Required DNS records:

docs.blueflyagents.com      A/CNAME to docs server
api.blueflyagents.com       A/CNAME to API gateway
agents.blueflyagents.com    A/CNAME to agent platform
*.agents.blueflyagents.com  Wildcard for agent services

Software Dependencies

Language Runtimes

Node.js:

  • Version: 20.x LTS
  • Package manager: npm 10.x

PHP:

  • Version: 8.3+
  • Extensions: mbstring, xml, curl, zip, gd, pdo_mysql
  • Composer: 2.6+

Python:

  • Version: 3.11+ (3.12 recommended)
  • pip: 23.0+
  • virtualenv or poetry

Build Tools

TypeScript:

npm install -g typescript@5.3+

ESLint:

npm install -g eslint@8.50+

Prettier:

npm install -g prettier@3.0+

Cloud Provider Requirements

AWS

Services:

  • EKS (Kubernetes)
  • RDS (PostgreSQL)
  • ElastiCache (Redis)
  • S3 (Object storage)
  • CloudWatch (Logging)
  • IAM (Access management)

IAM Permissions:

  • EKS full access
  • RDS full access
  • S3 read/write
  • CloudWatch write

Google Cloud

Services:

  • GKE (Kubernetes)
  • Cloud SQL (PostgreSQL)
  • Memorystore (Redis)
  • Cloud Storage (Object storage)
  • Cloud Logging

Azure

Services:

  • AKS (Kubernetes)
  • Azure Database for PostgreSQL
  • Azure Cache for Redis
  • Blob Storage
  • Azure Monitor

Development Tools

Required

IDE/Editor:

  • VS Code 1.85+ (recommended)
  • JetBrains WebStorm 2023.3+
  • Vim/Neovim with LSP

Git Client:

  • Command line git
  • GitLab CLI (glab)

Container Tools:

  • Docker Desktop 4.25+
  • OrbStack (macOS alternative)
  • Podman (Linux alternative)

Recommended Extensions (VS Code)

{
  "recommendations": [
    "dbaeumer.vscode-eslint",
    "esbenp.prettier-vscode",
    "ms-azuretools.vscode-docker",
    "ms-kubernetes-tools.vscode-kubernetes-tools",
    "gitlab.gitlab-workflow",
    "redhat.vscode-yaml",
    "tamasfe.even-better-toml"
  ]
}

Environment Variables

Required

export GITLAB_TOKEN="glpat-..."
export ANTHROPIC_API_KEY="sk-ant-..."

Optional

export OPENAI_API_KEY="sk-..."
export GITLAB_AI_GATEWAY_URL="http://gdk.test:5052"
export DATABASE_URL="postgresql://user:pass@localhost:5432/db"
export REDIS_URL="redis://localhost:6379"

Verification

Check All Requirements

# Node.js
node --version  # Should be v20.x.x

# Docker
docker --version  # Should be 24.0+

# Kubernetes
kubectl version --client  # Should be 1.28+

# GitLab CLI
glab version  # Should be 1.40+

# Environment variables
echo $GITLAB_TOKEN | wc -c  # Should be >20
echo $ANTHROPIC_API_KEY | wc -c  # Should be >20

Run Health Check

# Clone and run health check
git clone https://gitlab.com/blueflyio/agent-platform/agent-buildkit.git
cd agent-buildkit
npm install
npm run health-check

Troubleshooting

Node.js Version Issues

# Install nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Install Node 20
nvm install 20
nvm use 20
nvm alias default 20

Docker Permission Issues

# Add user to docker group (Linux)
sudo usermod -aG docker $USER
newgrp docker

Kubernetes Connection Issues

# Verify kubeconfig
kubectl config view

# Test connection
kubectl get nodes

Next Steps

  1. Verify all requirements met
  2. Development Setup - Set up your environment
  3. Your First Agent - Build your first agent

Version: 1.0.0
Last Updated: 2025-12-02
Next Review: 2025-12-16