b033923756
- Remove executable permissions from configuration files (.editorconfig, .env.example, .gitignore) - Remove executable permissions from documentation files (README.md, LICENSE, SECURITY.md) - Remove executable permissions from web assets (HTML, CSS, JS files) - Remove executable permissions from data files (JSON, SQL, YAML, requirements.txt) - Remove executable permissions from source code files across all apps - Add executable permissions to Python
191 lines
5.4 KiB
Markdown
191 lines
5.4 KiB
Markdown
# AITBC macOS Service Packages
|
|
|
|
## 🍎 **Individual Service Packages for Mac Studio**
|
|
|
|
Individual service packages for **Mac Studio** with **Apple Silicon** processors (M1, M2, M3, M4).
|
|
|
|
## 📦 **Available Service Packages**
|
|
|
|
### **Core Infrastructure**
|
|
- **`aitbc-node-service-0.1.0-apple-silicon.pkg`** - Blockchain node service
|
|
- **`aitbc-coordinator-service-0.1.0-apple-silicon.pkg`** - Coordinator API service
|
|
|
|
### **Application Services**
|
|
- **`aitbc-miner-service-0.1.0-apple-silicon.pkg`** - GPU miner service
|
|
- **`aitbc-marketplace-service-0.1.0-apple-silicon.pkg`** - Marketplace service
|
|
- **`aitbc-explorer-service-0.1.0-apple-silicon.pkg`** - Explorer service
|
|
- **`aitbc-wallet-service-0.1.0-apple-silicon.pkg`** - Wallet service
|
|
- **`aitbc-multimodal-service-0.1.0-apple-silicon.pkg`** - Multimodal AI service
|
|
|
|
### **Meta Package**
|
|
- **`aitbc-all-services-0.1.0-apple-silicon.pkg`** - Complete service stack
|
|
|
|
## 🚀 **Installation**
|
|
|
|
### **Option 1: Service Installer (Recommended)**
|
|
```bash
|
|
curl -fsSL https://raw.githubusercontent.com/aitbc/aitbc/main/packages/github/packages/macos-services/install-macos-services.sh | bash
|
|
```
|
|
|
|
### **Option 2: Individual Service Installation**
|
|
```bash
|
|
# Download specific service
|
|
curl -fsSL https://raw.githubusercontent.com/aitbc/aitbc/main/packages/github/packages/macos-services/aitbc-node-service-0.1.0-apple-silicon.pkg -o node.pkg
|
|
sudo installer -pkg node.pkg -target /
|
|
|
|
# Install multiple services
|
|
curl -fsSL https://raw.githubusercontent.com/aitbc/aitbc/main/packages/github/packages/macos-services/aitbc-coordinator-service-0.1.0-apple-silicon.pkg -o coordinator.pkg
|
|
sudo installer -pkg coordinator.pkg -target /
|
|
```
|
|
|
|
## 🎯 **Service Commands**
|
|
|
|
### **Node Service**
|
|
```bash
|
|
aitbc-node-service start
|
|
aitbc-node-service status
|
|
aitbc-node-service sync
|
|
aitbc-node-service peers
|
|
```
|
|
|
|
### **Coordinator Service**
|
|
```bash
|
|
aitbc-coordinator-service start
|
|
aitbc-coordinator-service status
|
|
aitbc-coordinator-service health
|
|
aitbc-coordinator-service jobs
|
|
```
|
|
|
|
### **Miner Service**
|
|
```bash
|
|
aitbc-miner-service start
|
|
aitbc-miner-service status
|
|
aitbc-miner-service hashrate
|
|
aitbc-miner-service earnings
|
|
```
|
|
|
|
### **Marketplace Service**
|
|
```bash
|
|
aitbc-marketplace-service start
|
|
aitbc-marketplace-service status
|
|
aitbc-marketplace-service listings
|
|
aitbc-marketplace-service orders
|
|
```
|
|
|
|
### **Explorer Service**
|
|
```bash
|
|
aitbc-explorer-service start
|
|
aitbc-explorer-service status
|
|
aitbc-explorer-service web
|
|
aitbc-explorer-service search
|
|
```
|
|
|
|
### **Wallet Service**
|
|
```bash
|
|
aitbc-wallet-service start
|
|
aitbc-wallet-service status
|
|
aitbc-wallet-service balance
|
|
aitbc-wallet-service transactions
|
|
```
|
|
|
|
### **Multimodal Service**
|
|
```bash
|
|
aitbc-multimodal-service start
|
|
aitbc-multimodal-service status
|
|
aitbc-multimodal-service process
|
|
aitbc-multimodal-service models
|
|
```
|
|
|
|
### **All Services**
|
|
```bash
|
|
aitbc-all-services start
|
|
aitbc-all-services status
|
|
aitbc-all-services restart
|
|
aitbc-all-services monitor
|
|
```
|
|
|
|
## 📊 **Service Configuration**
|
|
|
|
Each service creates its own configuration file:
|
|
- **Node**: `~/.config/aitbc/aitbc-node-service.yaml`
|
|
- **Coordinator**: `~/.config/aitbc/aitbc-coordinator-service.yaml`
|
|
- **Miner**: `~/.config/aitbc/aitbc-miner-service.yaml`
|
|
- **Marketplace**: `~/.config/aitbc/aitbc-marketplace-service.yaml`
|
|
- **Explorer**: `~/.config/aitbc/aitbc-explorer-service.yaml`
|
|
- **Wallet**: `~/.config/aitbc/aitbc-wallet-service.yaml`
|
|
- **Multimodal**: `~/.config/aitbc/aitbc-multimodal-service.yaml`
|
|
|
|
## 🔧 **Apple Silicon Optimization**
|
|
|
|
Each service is optimized for Apple Silicon:
|
|
- **Native ARM64 execution** - No Rosetta 2 needed
|
|
- **Apple Neural Engine** - AI/ML acceleration
|
|
- **Metal framework** - GPU optimization
|
|
- **Memory bandwidth** - Optimized for unified memory
|
|
|
|
## ⚠️ **Important Notes**
|
|
|
|
### **Platform Requirements**
|
|
- **Required**: Apple Silicon Mac (Mac Studio recommended)
|
|
- **OS**: macOS 12.0+ (Monterey or later)
|
|
- **Memory**: 16GB+ recommended for multiple services
|
|
|
|
### **Demo Packages**
|
|
These are **demo packages** for demonstration:
|
|
- Show service structure and installation
|
|
- Demonstrate Apple Silicon optimization
|
|
- Provide installation framework
|
|
|
|
For **full functionality**, use Python installation:
|
|
```bash
|
|
curl -fsSL https://raw.githubusercontent.com/aitbc/aitbc/main/packages/github/install-macos.sh | bash
|
|
```
|
|
|
|
## ✅ **Verification**
|
|
|
|
### **Package Integrity**
|
|
```bash
|
|
sha256sum -c checksums.txt
|
|
```
|
|
|
|
### **Service Installation Test**
|
|
```bash
|
|
# Test all installed services
|
|
aitbc-node-service --version
|
|
aitbc-coordinator-service --version
|
|
aitbc-miner-service --version
|
|
```
|
|
|
|
### **Service Status**
|
|
```bash
|
|
# Check service status
|
|
aitbc-all-services status
|
|
```
|
|
|
|
## 🔄 **Service Dependencies**
|
|
|
|
### **Startup Order**
|
|
1. **Node Service** - Foundation
|
|
2. **Coordinator Service** - Job coordination
|
|
3. **Marketplace Service** - GPU marketplace
|
|
4. **Wallet Service** - Wallet operations
|
|
5. **Explorer Service** - Blockchain explorer
|
|
6. **Miner Service** - GPU mining
|
|
7. **Multimodal Service** - AI processing
|
|
|
|
### **Service Communication**
|
|
- **Node → Coordinator**: Blockchain data access
|
|
- **Coordinator → Marketplace**: Job coordination
|
|
- **Marketplace → Miner**: GPU job distribution
|
|
- **All Services → Node**: Blockchain interaction
|
|
|
|
## 📚 **Documentation**
|
|
|
|
- **[Main Documentation](../README.md)** - Complete installation guide
|
|
- **[Apple Silicon Optimization](../DEBIAN_TO_MACOS_BUILD.md)** - Build system details
|
|
- **[Package Distribution](../packages/README.md)** - Package organization
|
|
|
|
---
|
|
|
|
**Individual AITBC service packages for Mac Studio!** 🚀
|