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

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

Command Groups

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

Client Workflow

aitbc wallet balance                                # check funds
aitbc client submit --prompt "What is AI?"          # submit job
aitbc client status --job-id <JOB_ID>               # check progress
aitbc client download --job-id <JOB_ID> --output ./ # get results

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.