aitbc/.windsurf/skills/ollama-gpu-provider/SKILL.md

name, title, description, version, author, tags

name	title	description	version	author	tags
ollama-gpu-provider	Ollama GPU Provider Complete Test Workflow	Complete end-to-end test workflow for Ollama GPU inference jobs including client submission, miner processing, receipt generation, payment processing, and blockchain recording	2.0	AITBC Team	ollama gpu miner testing workflow blockchain payment

Ollama GPU Provider Complete Test Workflow

This skill provides a comprehensive test workflow for verifying the entire Ollama GPU inference pipeline from client job submission through blockchain transaction recording.

Overview

The complete flow includes:

1. Client submits inference job to coordinator
2. GPU miner picks up and processes job via Ollama
3. Miner submits result with metrics
4. Coordinator generates signed receipt
5. Client processes payment to miner
6. Transaction recorded on blockchain

Prerequisites

Required Services

• Coordinator API running on port 18000
• GPU miner service running (aitbc-host-gpu-miner.service)
• Ollama service running on port 11434
• Blockchain node accessible (local: 19000 or remote: aitbc.keisanki.net/rpc)
• Home directory wallets configured

Configuration

# Verify services
./scripts/aitbc-cli.sh health
curl -s http://localhost:11434/api/tags
systemctl status aitbc-host-gpu-miner.service

Test Options

Option 1: Basic API Test (No Payment)

# Simple test without blockchain
python3 cli/test_ollama_gpu_provider.py \
  --url http://127.0.0.1:18000 \
  --prompt "What is the capital of France?" \
  --model llama3.2:latest

Option 2: Complete Workflow with Home Directory Users

# Full test with payment and blockchain
cd /home/oib/windsurf/aitbc/home
python3 test_ollama_blockchain.py

Option 3: Manual Step-by-Step

# 1. Submit job
cd /home/oib/windsurf/aitbc/home
job_id=$(../cli/client.py submit inference \
  --prompt "What is the capital of France?" \
  --model llama3.2:latest | grep "Job ID" | awk '{print $3}')

# 2. Monitor progress
watch -n 2 "../cli/client.py status $job_id"

# 3. Get result and receipt
curl -H "X-Api-Key: REDACTED_CLIENT_KEY" \
  "http://127.0.0.1:18000/v1/jobs/$job_id/result" | python3 -m json.tool

# 4. Process payment (manual)
miner_addr=$(cd miner && python3 wallet.py address | grep Address | awk '{print $3}')
amount=0.05  # Based on receipt
cd client && python3 wallet.py send $amount $miner_addr "Payment for job $job_id"

# 5. Record earnings
cd ../miner && python3 wallet.py earn $amount --job $job_id --desc "Inference job"

# 6. Check blockchain
curl -s "http://aitbc.keisanki.net/rpc/transactions" | \
  python3 -c "import sys, json; data=json.load(sys.stdin); \
    [print(f\"TX: {t['tx_hash']} - Block: {t['block_height']}\") \
    for t in data.get('transactions', []) \
    if 'receipt_id' in str(t.get('payload', {}))]"

Expected Results

Step	Expected Output	Verification
Job Submission	Job ID returned, state = QUEUED	client.py status shows job
Processing	State → RUNNING, miner assigned	Miner logs show job pickup
Completion	State = COMPLETED, output received	Result endpoint returns data
Receipt	Generated with price > 0	Receipt has valid signature
Payment	Client balance ↓, miner ↑	Wallet balances update
Blockchain	Transaction recorded	TX hash searchable

Monitoring Commands

# Real-time miner logs
sudo journalctl -u aitbc-host-gpu-miner.service -f

# Recent receipts
curl -H "X-Api-Key: REDACTED_CLIENT_KEY" \
  http://127.0.0.1:18000/v1/explorer/receipts?limit=5

# Wallet balances
cd /home/oib/windsurf/aitbc/home && \
  echo "Client:" && cd client && python3 wallet.py balance && \
  echo "Miner:" && cd ../miner && python3 wallet.py balance

# Blockchain transactions
curl -s http://aitbc.keisanki.net/rpc/transactions | python3 -m json.tool

Troubleshooting

Job Stuck in QUEUED

# Check miner service
systemctl status aitbc-host-gpu-miner.service

# Restart if needed
sudo systemctl restart aitbc-host-gpu-miner.service

# Check miner registration
curl -H "X-Api-Key: REDACTED_ADMIN_KEY" \
  http://127.0.0.1:18000/v1/admin/miners

No Receipt Generated

# Verify receipt signing key
grep receipt_signing_key_hex /opt/coordinator-api/src/.env

# Check job result for receipt
curl -H "X-Api-Key: REDACTED_CLIENT_KEY" \
  http://127.0.0.1:18000/v1/jobs/<job_id>/result | jq .receipt

Payment Issues

# Check wallet addresses
cd /home/oib/windsurf/aitbc/home/client && python3 wallet.py address
cd /home/oib/windsurf/aitbc/home/miner && python3 wallet.py address

# Verify transaction
python3 wallet.py transactions

Blockchain Not Recording

# Check node availability
curl -s http://aitbc.keisanki.net/rpc/health

# Search for receipt
curl -s "http://aitbc.keisanki.net/rpc/transactions" | \
  grep <receipt_id>

Test Data Examples

Sample Job Result

{
  "result": {
    "output": "The capital of France is Paris.",
    "model": "llama3.2:latest",
    "tokens_processed": 8,
    "execution_time": 0.52,
    "gpu_used": true
  },
  "receipt": {
    "receipt_id": "8c4db70a1d413188681e003f0de7342f",
    "units": 2.603,
    "unit_price": 0.02,
    "price": 0.05206
  }
}

Sample Blockchain Transaction

{
  "tx_hash": "0xabc123...",
  "block_height": 12345,
  "sender": "aitbc18f75b7eb7e2ecc7567b6",
  "recipient": "aitbc1721d5bf8c0005ded6704",
  "amount": 0.05206,
  "payload": {
    "receipt_id": "8c4db70a1d413188681e003f0de7342f"
  }
}

Integration with CI/CD

# GitHub Actions example
- name: Run Ollama GPU Provider Test
  run: |
    cd /home/oib/windsurf/aitbc/home
    python3 test_ollama_blockchain.py --timeout 300

Related Files

• /home/oib/windsurf/aitbc/home/test_ollama_blockchain.py - Complete test script
• /home/oib/windsurf/aitbc/cli/test_ollama_gpu_provider.py - Basic API test
• /home/oib/windsurf/aitbc/.windsurf/skills/blockchain-operations/ - Blockchain management
• /home/oib/windsurf/aitbc/docs/infrastructure.md - Infrastructure details