aitbc/docs/0_getting_started/3_cli.md

CLI Usage

Setup

pip install -e .                                    # from monorepo root
aitbc config set coordinator_url http://localhost:8000
export AITBC_API_KEY=your-key                       # or use --api-key

Verify Installation

# Check CLI version and platform
aitbc --version
aitbc --debug

# Test connectivity
aitbc blockchain status
aitbc --config

Global Options

Option	Description
--url URL	Coordinator API URL
--api-key KEY	API key for authentication
--output table|json|yaml	Output format
-v / -vv / -vvv	Verbosity level
--debug	Debug mode with system information
--config	Show current configuration

Enhanced Command Groups

Group	Key commands
agent	workflow create, execute, network, learning enable
multimodal	agent, process, convert, search
optimize	enable, status, recommendations, apply, predict, tune
openclaw	deploy, status, optimize, edge, routing, ecosystem
marketplace	list, gpu list, offer create, gpu rent, orders, reviews
swarm	join, coordinate, consensus
client	submit, status, list, cancel, download, batch-submit
miner	register, poll, mine, earnings, deregister
wallet	create, balance, send, stake, backup, multisig-create
auth	login, logout, token, keys
blockchain	status, sync, info, peers, blocks, transaction, validators
admin	status, jobs, miners, audit-log
config	set, show, profiles, secrets, get
monitor	dashboard, metrics, alerts, webhooks
simulate	workflow, load-test, scenario

Enhanced Client Workflow

# Setup and configuration
aitbc wallet create --name my-wallet               # create wallet
aitbc wallet balance                                 # check funds
aitbc config show                                   # verify configuration

# Job submission with enhanced options
aitbc client submit --prompt "What is AI?" \
  --model gpt2 \
  --priority normal \
  --timeout 3600

# Job tracking and management
aitbc client status --job-id <JOB_ID>               # check progress
aitbc client download --job-id <JOB_ID> --output ./ # get results
aitbc client list --status completed                 # list completed jobs

Agent Workflow (New)

# Agent workflow management
aitbc agent workflow create \
  --name "ai_inference" \
  --description "AI inference workflow" \
  --config '{"model": "gpt2", "type": "inference"}'

# Execute agent workflow
aitbc agent execute ai_inference \
  --input '{"prompt": "Hello world"}' \
  --priority normal

# Agent learning and optimization
aitbc agent learning enable --agent-id agent_123 \
  --mode performance \
  --auto-tune

# Agent networks
aitbc agent network create \
  --name "compute_network" \
  --type "resource_sharing"

OpenClaw Deployment (New)

# Deploy applications
aitbc openclaw deploy \
  --name "web_app" \
  --image "nginx:latest" \
  --replicas 3 \
  --region "us-west"

# Monitor and optimize deployments
aitbc openclaw status web_app
aitbc openclaw optimize web_app \
  --target performance \
  --auto-tune

# Edge deployments
aitbc openclaw edge deploy \
  --name "edge_service" \
  --compute "gpu" \
  --region "edge_location"

Optimization Features (New)

# Enable agent optimization
aitbc optimize enable --agent-id agent_123 \
  --mode performance \
  --auto-tune

# Get optimization recommendations
aitbc optimize recommendations --agent-id agent_123

# Apply optimizations
aitbc optimize apply --agent-id agent_123 \
  --recommendation-id rec_456

# Predictive scaling
aitbc optimize predict --agent-id agent_123 \
  --metric cpu_usage \
  --horizon 1h

# Auto-tuning
aitbc optimize tune --agent-id agent_123 \
  --objective performance \
  --constraints '{"cost": "<100"}'

Enhanced Marketplace Operations

# List available GPUs
aitbc marketplace gpu list

# Register 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"

# Rent GPU
aitbc marketplace gpu rent --gpu-id gpu_789 --duration 2h

# Track orders and reviews
aitbc marketplace orders --status active
aitbc marketplace reviews --miner-id gpu_miner_123

Enhanced Blockchain Operations

# Blockchain status and synchronization
aitbc blockchain status
aitbc blockchain sync
aitbc blockchain info

# Network and peers
aitbc blockchain peers
aitbc blockchain blocks --limit 10

# Transactions and validators
aitbc blockchain transaction <TX_ID>
aitbc blockchain validators

Enhanced Configuration Management

# Configuration management
aitbc config show
aitbc config set coordinator_url http://localhost:8000
aitbc config get api_key
aitbc config profiles list
aitbc config profiles create development

# Secrets management
aitbc config secrets set api_key your_secret_key
aitbc config secrets get api_key

Debug and Troubleshooting

# Debug mode with system information
aitbc --debug

# Monitor CLI performance
aitbc monitor dashboard
aitbc monitor metrics --component cli

# Simulation and testing
aitbc simulate workflow --test-scenario basic
aitbc simulate load-test --concurrent-users 10

Miner Workflow

aitbc miner register --name gpu-1 --gpu a100 --count 4
aitbc miner poll                                    # start accepting jobs
aitbc wallet balance                                # check earnings

Advanced AI Agent Workflows

# Create and execute advanced AI agents
aitbc agent create --name "MultiModal Agent" --workflow-file workflow.json --verification full
aitbc agent execute agent_123 --inputs inputs.json --verification zero-knowledge

# Multi-modal processing
aitbc multimodal agent create --name "Vision-Language Agent" --modalities text,image --gpu-acceleration
aitbc multimodal process agent_123 --text "Describe this image" --image photo.jpg

# Autonomous optimization
aitbc optimize self-opt enable agent_123 --mode auto-tune --scope full
aitbc optimize predict agent_123 --horizon 24h --resources gpu,memory

Agent Collaboration & Learning

# Create collaborative agent networks
aitbc agent network create --name "Research Team" --agents agent1,agent2,agent3
aitbc agent network execute network_123 --task research_task.json

# Adaptive learning
aitbc agent learning enable agent_123 --mode reinforcement --learning-rate 0.001
aitbc agent learning train agent_123 --feedback feedback.json --epochs 50

OpenClaw Edge Deployment

# Deploy to OpenClaw network
aitbc openclaw deploy agent_123 --region us-west --instances 3 --auto-scale
aitbc openclaw edge deploy agent_123 --locations "us-west,eu-central" --strategy latency

# Monitor and optimize
aitbc openclaw monitor deployment_123 --metrics latency,cost --real-time
aitbc openclaw optimize deployment_123 --objective cost

Advanced Marketplace Operations

# Advanced NFT model operations
aitbc marketplace advanced models list --nft-version 2.0 --category multimodal
aitbc marketplace advanced mint --model-file model.pkl --metadata metadata.json --royalty 5.0

# Analytics and trading
aitbc marketplace advanced analytics --period 30d --metrics volume,trends
aitbc marketplace advanced trading execute --strategy arbitrage --budget 5000

Swarm Intelligence

# Join swarm for collective optimization
aitbc swarm join --role load-balancer --capability resource-optimization
aitbc swarm coordinate --task network-optimization --collaborators 10

Configuration

Config file: ~/.aitbc/config.yaml

coordinator_url: http://localhost:8000
api_key: your-api-key
output_format: table
log_level: INFO

Troubleshooting

Problem	Fix
Auth error	export AITBC_API_KEY=your-key or aitbc auth login
Connection refused	Check coordinator: curl http://localhost:8000/v1/health
Unknown command	Update CLI: pip install -e . from monorepo root
Agent command not found	Ensure advanced agent commands are installed: pip install -e .
Multi-modal processing error	Check GPU availability: nvidia-smi
OpenClaw deployment failed	Verify OpenClaw credentials and region access
Marketplace NFT error	Check model file format and metadata structure

Advanced Agent Documentation

See docs/11_agents/ for detailed guides:

• Advanced AI Agents - Multi-modal and adaptive agents
• Agent Collaboration - Networks and learning
• OpenClaw Integration - Edge deployment
• Swarm Intelligence - Collective optimization

Full Reference

See 5_reference/1_cli-reference.md for all 90+ commands with detailed options.