825f157749
- Bump minimum Python version from 3.11 to 3.13 across all apps - Add Python 3.11-3.13 test matrix to CLI workflow - Document Python 3.11+ requirement in .env.example - Fix Starlette Broadcast removal with in-process fallback implementation - Add _InProcessBroadcast class for tests when Starlette Broadcast is unavailable - Refactor API key validators to read live settings instead of cached values - Update database models with explicit
152 lines
5.4 KiB
Markdown
152 lines
5.4 KiB
Markdown
# CLI Usage
|
|
|
|
## Setup
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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`
|
|
```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/](../11_agents/) for detailed guides:
|
|
- [Advanced AI Agents](../11_agents/advanced-ai-agents.md) - Multi-modal and adaptive agents
|
|
- [Agent Collaboration](../11_agents/collaborative-agents.md) - Networks and learning
|
|
- [OpenClaw Integration](../11_agents/openclaw-integration.md) - Edge deployment
|
|
- [Swarm Intelligence](../11_agents/swarm/) - Collective optimization
|
|
|
|
## Full Reference
|
|
|
|
See [5_reference/1_cli-reference.md](../5_reference/1_cli-reference.md) for all 90+ commands with detailed options.
|