Files
aitbc/docs/19_marketplace/CLI_TOOLS.md
AITBC System b033923756 chore: normalize file permissions across repository
- 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
2026-03-08 11:26:18 +01:00

500 lines
11 KiB
Markdown

# AITBC CLI Marketplace Tools
## Overview
The enhanced AITBC CLI provides comprehensive marketplace tools for GPU computing, resource management, and global marketplace operations. This guide covers all CLI commands for marketplace participants.
## 🏪 Marketplace Command Group
### Basic Marketplace Operations
```bash
# List all marketplace resources
aitbc marketplace list
# List available GPUs with details
aitbc marketplace gpu list
# List GPUs by region
aitbc marketplace gpu list --region us-west
# List GPUs by model
aitbc marketplace gpu list --model rtx4090
# List GPUs by price range
aitbc marketplace gpu list --max-price 0.05
```
### GPU Offer Management
#### Create GPU Offer
```bash
# Basic GPU offer
aitbc marketplace offer create \
--miner-id gpu_miner_123 \
--gpu-model "RTX-4090" \
--gpu-memory "24GB" \
--price-per-hour "0.05" \
--models "gpt2,llama" \
--endpoint "http://localhost:11434"
# Advanced GPU offer with more options
aitbc marketplace offer create \
--miner-id gpu_miner_456 \
--gpu-model "A100" \
--gpu-memory "40GB" \
--gpu-count 4 \
--price-per-hour "0.10" \
--models "gpt4,claude,llama2" \
--endpoint "http://localhost:11434" \
--region us-west \
--availability "24/7" \
--min-rental-duration 1h \
--max-rental-duration 168h \
--performance-tier "premium"
```
#### List and Manage Offers
```bash
# List your offers
aitbc marketplace offers --miner-id gpu_miner_123
# List all active offers
aitbc marketplace offers --status active
# Update offer pricing
aitbc marketplace offer update \
--offer-id offer_789 \
--price-per-hour "0.06"
# Deactivate offer
aitbc marketplace offer deactivate --offer-id offer_789
# Reactivate offer
aitbc marketplace offer activate --offer-id offer_789
# Delete offer permanently
aitbc marketplace offer delete --offer-id offer_789
```
### GPU Rental Operations
#### Rent GPU
```bash
# Basic GPU rental
aitbc marketplace gpu rent \
--gpu-id gpu_789 \
--duration 2h
# Advanced GPU rental
aitbc marketplace gpu rent \
--gpu-id gpu_789 \
--duration 4h \
--auto-renew \
--max-budget 1.0
# Rent by specifications
aitbc marketplace gpu rent \
--gpu-model "RTX-4090" \
--gpu-memory "24GB" \
--duration 2h \
--region us-west
```
#### Manage Rentals
```bash
# List active rentals
aitbc marketplace rentals --status active
# List rental history
aitbc marketplace rentals --history
# Extend rental
aitbc marketplace rental extend \
--rental-id rental_456 \
--additional-duration 2h
# Cancel rental
aitbc marketplace rental cancel --rental-id rental_456
# Monitor rental usage
aitbc marketplace rental monitor --rental-id rental_456
```
### Order Management
```bash
# List all orders
aitbc marketplace orders
# List orders by status
aitbc marketplace orders --status pending
aitbc marketplace orders --status completed
aitbc marketplace orders --status cancelled
# List your orders
aitbc marketplace orders --miner-id gpu_miner_123
# Order details
aitbc marketplace order details --order-id order_789
# Accept order
aitbc marketplace order accept --order-id order_789
# Reject order
aitbc marketplace order reject --order-id order_789 --reason "GPU unavailable"
# Complete order
aitbc marketplace order complete --order-id order_789
```
### Review and Rating System
```bash
# Leave review for miner
aitbc marketplace review create \
--miner-id gpu_miner_123 \
--rating 5 \
--comment "Excellent performance, fast response"
# Leave review for renter
aitbc marketplace review create \
--renter-id client_456 \
--rating 4 \
--comment "Good experience, minor delay"
# List reviews for miner
aitbc marketplace reviews --miner-id gpu_miner_123
# List reviews for renter
aitbc marketplace reviews --renter-id client_456
# List your reviews
aitbc marketplace reviews --my-reviews
# Update review
aitbc marketplace review update \
--review-id review_789 \
--rating 5 \
--comment "Updated: Excellent after support"
```
### Global Marketplace Operations
```bash
# List global marketplace statistics
aitbc marketplace global stats
# List regions
aitbc marketplace global regions
# Region-specific operations
aitbc marketplace global offers --region us-west
aitbc marketplace global rentals --region europe
# Cross-chain operations
aitbc marketplace global cross-chain \
--source-chain ethereum \
--target-chain polygon \
--amount 100
# Global analytics
aitbc marketplace global analytics --period 24h
aitbc marketplace global analytics --period 7d
```
## 🔍 Search and Filtering
### Advanced Search
```bash
# Search GPUs by multiple criteria
aitbc marketplace gpu list \
--model rtx4090 \
--memory-min 16GB \
--price-max 0.05 \
--region us-west
# Search offers by availability
aitbc marketplace offers search \
--available-now \
--min-duration 2h
# Search by performance tier
aitbc marketplace gpu list --performance-tier premium
aitbc marketplace gpu list --performance-tier standard
```
### Filtering and Sorting
```bash
# Sort by price (lowest first)
aitbc marketplace gpu list --sort price
# Sort by performance (highest first)
aitbc marketplace gpu list --sort performance --descending
# Filter by availability
aitbc marketplace gpu list --available-only
# Filter by minimum rental duration
aitbc marketplace gpu list --min-duration 4h
```
## 📊 Analytics and Reporting
### Usage Analytics
```bash
# Personal usage statistics
aitbc marketplace analytics personal
# Spending analytics
aitbc marketplace analytics spending --period 30d
# Earnings analytics (for miners)
aitbc marketplace analytics earnings --period 7d
# Performance analytics
aitbc marketplace analytics performance --gpu-id gpu_789
```
### Marketplace Analytics
```bash
# Overall marketplace statistics
aitbc marketplace analytics market
# Regional analytics
aitbc marketplace analytics regions
# Model popularity analytics
aitbc marketplace analytics models
# Price trend analytics
aitbc marketplace analytics prices --period 7d
```
## ⚙️ Configuration and Preferences
### Marketplace Configuration
```bash
# Set default preferences
aitbc marketplace config set default-region us-west
aitbc marketplace config set max-price 0.10
aitbc marketplace config set preferred-model rtx4090
# Show configuration
aitbc marketplace config show
# Reset configuration
aitbc marketplace config reset
```
### Notification Settings
```bash
# Enable notifications
aitbc marketplace notifications enable --type price-alerts
aitbc marketplace notifications enable --type rental-reminders
# Set price alerts
aitbc marketplace alerts create \
--type price-drop \
--gpu-model rtx4090 \
--target-price 0.04
# Set rental reminders
aitbc marketplace alerts create \
--type rental-expiry \
--rental-id rental_456 \
--reminder-time 30m
```
## 🔧 Advanced Operations
### Batch Operations
```bash
# Batch offer creation from file
aitbc marketplace batch-offers create --file offers.json
# Batch rental management
aitbc marketplace batch-rentals extend --file rentals.json
# Batch price updates
aitbc marketplace batch-prices update --file price_updates.json
```
### Automation Scripts
```bash
# Auto-renew rentals
aitbc marketplace auto-renew enable --max-budget 10.0
# Auto-accept orders (for miners)
aitbc marketplace auto-accept enable --min-rating 4
# Auto-price adjustment
aitbc marketplace auto-price enable --strategy market-based
```
### Integration Tools
```bash
# Export data for analysis
aitbc marketplace export --format csv --file marketplace_data.csv
# Import offers from external source
aitbc marketplace import --file external_offers.json
# Sync with external marketplace
aitbc marketplace sync --source external_marketplace
```
## 🌍 Global Marketplace Features
### Multi-Region Operations
```bash
# List available regions
aitbc marketplace global regions
# Region-specific pricing
aitbc marketplace global pricing --region us-west
# Cross-region arbitrage
aitbc marketplace global arbitrage --source-region us-west --target-region europe
```
### Cross-Chain Operations
```bash
# List supported chains
aitbc marketplace global chains
# Cross-chain pricing
aitbc marketplace global pricing --chain polygon
# Cross-chain transactions
aitbc marketplace global transfer \
--amount 100 \
--from-chain ethereum \
--to-chain polygon
```
## 🛡️ Security and Trust
### Trust Management
```bash
# Check trust score
aitbc marketplace trust score --miner-id gpu_miner_123
# Verify miner credentials
aitbc marketplace verify --miner-id gpu_miner_123
# Report suspicious activity
aitbc marketplace report \
--type suspicious \
--target-id gpu_miner_123 \
--reason "Unusual pricing patterns"
```
### Dispute Resolution
```bash
# Create dispute
aitbc marketplace dispute create \
--order-id order_789 \
--reason "Performance not as advertised"
# List disputes
aitbc marketplace disputes --status open
# Respond to dispute
aitbc marketplace dispute respond \
--dispute-id dispute_456 \
--response "Offering partial refund"
```
## 📝 Best Practices
### For Miners
1. **Competitive Pricing**: Use `aitbc marketplace analytics prices` to set competitive rates
2. **High Availability**: Keep offers active and update availability regularly
3. **Good Reviews**: Provide excellent service to build reputation
4. **Performance Monitoring**: Use `aitbc marketplace analytics performance` to track GPU performance
### For Renters
1. **Price Comparison**: Use `aitbc marketplace gpu list --sort price` to find best deals
2. **Review Check**: Use `aitbc marketplace reviews --miner-id` before renting
3. **Budget Management**: Set spending limits and track usage with analytics
4. **Rental Planning**: Use auto-renew for longer projects
### For Both
1. **Security**: Enable two-factor authentication and monitor account activity
2. **Notifications**: Set up alerts for important events
3. **Data Backup**: Regularly export transaction history
4. **Market Awareness**: Monitor market trends and adjust strategies
## 🔗 Integration Examples
### Script Integration
```bash
#!/bin/bash
# Find best GPU for specific requirements
BEST_GPU=$(aitbc marketplace gpu list \
--model rtx4090 \
--max-price 0.05 \
--available-only \
--output json | jq -r '.[0].gpu_id')
echo "Best GPU found: $BEST_GPU"
# Rent the GPU
aitbc marketplace gpu rent \
--gpu-id $BEST_GPU \
--duration 4h \
--auto-renew
```
### API Integration
```bash
# Export marketplace data for external processing
aitbc marketplace gpu list --output json > gpu_data.json
# Process with external tools
python process_gpu_data.py gpu_data.json
# Import results back
aitbc marketplace import --file processed_offers.json
```
## 🆕 Migration from Legacy Commands
If you're transitioning from legacy marketplace commands:
| Legacy Command | Enhanced CLI Command |
|---------------|----------------------|
| `aitbc marketplace list` | `aitbc marketplace list` |
| `aitbc marketplace gpu list` | `aitbc marketplace gpu list` |
| `aitbc marketplace rent` | `aitbc marketplace gpu rent` |
| `aitbc marketplace offers` | `aitbc marketplace offers` |
## 📞 Support and Help
### Command Help
```bash
# General help
aitbc marketplace --help
# Specific command help
aitbc marketplace gpu list --help
aitbc marketplace offer create --help
```
### Troubleshooting
```bash
# Check marketplace status
aitbc marketplace status
# Test connectivity
aitbc marketplace test-connectivity
# Debug mode
aitbc marketplace --debug
```
---
*This guide covers all AITBC CLI marketplace tools for GPU computing, resource management, and global marketplace operations.*