Deployment Guide
I. Basic Requirements
CPU: Minimum 4 cores, recommended 8 cores
Memory: > 16GB
GPU (Single Card): Nvidia RTX 3090 or higher (minimum 32GB VRAM required)
Hard Drive: > 512GB
Internet: 5-10M
System: Supports Windows and Linux
II. Install Docker
Prerequisites
Ensure your system supports Docker and has the NVIDIA driver installed to support GPU.
Installation Steps:
Update package index:
sudo apt-get update
Install required packages:
sudo apt-get install apt-transport-https ca-certificates curl software-properties-common
Add Docker's official GPG key:
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
Set up Docker stable repository:
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
Update package index again:
sudo apt-get update
Install Docker CE:
sudo apt-get install docker-ce
Install NVIDIA Container Toolkit:
sudo curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo apt-key add -
distribution=$(. /etc/os-release;echo $ID$VERSION_ID)
sudo curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | sudo tee /etc/apt/sources.list.d/nvidia-docker.list
sudo apt-get update
sudo apt-get install -y nvidia-docker2
sudo systemctl restart docker
Start and enable Docker service:
sudo systemctl start docker
sudo systemctl enable docker
Verify installation:
docker --version
Windows System Installation
Prerequisites
Windows 10/11 Pro, Enterprise, or Education (64-bit)
Hyper-V and container features enabled
NVIDIA drivers installed
Installation Steps
Download Docker Desktop for Windows:
Download Windows version
Install Docker Desktop:
Run the downloaded installer
Follow the installation wizard to complete installation
Restart computer
Configure Docker Desktop:
Start Docker Desktop
Enable WSL 2 backend in settings (recommended)
Configure resource allocation (recommend at least 8GB memory)
Install NVIDIA Container Toolkit:
Download and install NVIDIA Container Toolkit for Windows
Configure Docker to use NVIDIA runtime
Verify installation:
docker --version
macOS System Installation
Prerequisites
macOS 10.15 or higher
Homebrew installed (recommended)
Installation Steps
Install using Homebrew (recommended):
brew install --cask docker
Or download manually:
Download macOS version
Drag to Applications folder
Start Docker Desktop:
Launch Docker Desktop from Applications
Complete initial setup
Configure resource allocation:
Configure memory and CPU allocation in Docker Desktop settings
Recommend at least 8GB memory allocation
Verify installation:
docker --version
Note: Docker on macOS does not support GPU acceleration, only CPU inference is supported.
Operating System Specific Notes
Linux System
Ensure NVIDIA drivers and CUDA are installed
Recommend using Ubuntu 20.04 or higher
Ensure Docker service is started and set to auto-start
Windows System
Requires Windows 10/11 Pro or higher
Ensure Hyper-V and WSL 2 are enabled
Recommend using WSL 2 backend for better performance
Ensure Docker Desktop has sufficient resource allocation
macOS System
Supports macOS 10.15 or higher
Does not support GPU acceleration, only CPU inference
Recommend using Homebrew for package management
Ensure Docker Desktop has sufficient resource allocation
III. Install Docker Compose
Linux System Installation
Download latest version:
sudo curl -L "https://github.com/docker/compose/releases/download/v2.5.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
Add executable permissions:
sudo chmod +x /usr/local/bin/docker-compose
Verify installation:
docker-compose --version
Windows System Installation
Docker Desktop for Windows already includes Docker Compose, no separate installation needed.
Verify installation:
docker-compose --version
macOS System Installation
Docker Desktop for macOS already includes Docker Compose, no separate installation needed.
Verify installation:
docker-compose --version
IV. Install Git
Linux System Installation
Update package list:
sudo apt-get update
Install Git:
sudo apt-get install git
Verify installation:
git --version
Windows System Installation
Download Git for Windows:
Visit Git official website
Download Windows version
Install Git:
Run the downloaded installer
Follow the installation wizard to complete installation
Recommend using default settings
Verify installation:
git --version
macOS System Installation
Install using Homebrew (recommended):
brew install git
Or use Xcode Command Line Tools:
xcode-select --install
Verify installation:
git --version
V. Deploy the HyperAGI Inference System
Clone the Repository
Linux/macOS:
git clone https://github.com/HyperdustLab/moss-inference-engine
cd moss-inference-engine
Windows:
git clone https://github.com/HyperdustLab/moss-inference-engine
cd moss-inference-engine
Or using PowerShell:
git clone https://github.com/HyperdustLab/moss-inference-engine
cd moss-inference-engine
Environment Variables Configuration Guide
1. Required Configuration Items
WALLET_ADDRESS
Description: Ethereum wallet address for receiving earnings
Format: 0x-prefixed 42-character Ethereum address
Example:
WALLET_ADDRESS=0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6
2. Network Configuration
PUBLIC_IP
Description: Public IP address, obtained from easytier logs
Obtainment Steps:
Start easytier service:
docker-compose up -d easytier
View logs:
docker-compose logs easytier
Search for
dhcp ip changed
informationExtract IP address (e.g.:
43.159.42.3
)
Example:
PUBLIC_IP=43.159.42.3
NODE
Description: Node ID, assigned by the platform
Obtainment Method: Platform staff will inform you of your node ID
Example:
NODE=your_node_id
3. Configuration Examples
Configure .env File
The .env
file in the project root directory contains the following configuration:
# Required configuration items
WALLET_ADDRESS=0xYourEthereumWalletAddress # Your Ethereum wallet address
PUBLIC_IP=43.159.42.3 # Obtained from easytier logs
NODE=your_node_id # Platform-assigned node ID
docker-compose.yaml Configuration
The docker-compose.yaml
file is already configured to use environment variables:
services:
nacos:
image: hyperagi/nacos-client:last
environment:
- PUBLIC_IP=${PUBLIC_IP}
- NODE=${NODE}
- PORT=8881
- WALLET_ADDRESS=${WALLET_ADDRESS}
- SERVICE_NAME=cogito:32b
restart: always
4. Configuration Steps
2.Edit .env file:
Linux/macOS:
nano .env
# or use vim
vim .env
Windows (PowerShell):
notepad .env
# or use VS Code
code .env
Windows (CMD):
notepad .env
2.Configure environment variables:
Set
WALLET_ADDRESS
to your Ethereum wallet addressStart easytier to obtain
PUBLIC_IP
Set
NODE
to platform-assigned node ID
3.Save and start services:
Linux/macOS:
docker-compose up -d
Windows:
docker-compose up -d
7. Verify Configuration
Check if configuration is correct:
Linux/macOS:
# View nacos service logs
docker-compose logs nacos
# Check service status
docker-compose ps
Windows:
# View nacos service logs
docker-compose logs nacos
# Check service status
docker-compose ps
8. Common Configuration Errors
Incorrect wallet address format
Ensure it starts with
0x
Ensure it's 42 characters long
Ensure it's a valid Ethereum address
Incorrect PUBLIC_IP configuration
Ensure it's correctly obtained from easytier logs
Don't use local IP addresses
Don't use public IP addresses
Incorrect NODE configuration
Ensure you use the platform-assigned node ID
Don't set or guess on your own
9. Configuration Checklist
10. Important Notes
Environment variable priority:
Docker Compose automatically loads the
.env
file in the project root directoryIf environment variables are set in the system, they will override values in the
.env
file
.env file security:
The
.env
file contains sensitive information, ensure it's not committed to version control
11. Getting Help
If you encounter issues during configuration:
View service logs for detailed error information
Check network connection and firewall settings
Confirm
.env
file configuration is correctVerify environment variables are loaded correctly
Contact technical support team
Support
For additional assistance, please refer to the documentation or seek support from the community.
Telegram Group:https://t.me/realMOSSCoin
Last updated