Troubleshooting

raxe doctor

# Upgrade pip first
pip install --upgrade pip

# Try with no cache
pip install raxe --no-cache-dir

# Use a virtual environment
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install raxe

# Check version
python --version

# Install Python 3.11 with pyenv
pyenv install 3.11
pyenv local 3.11

# Install without ML first
pip install raxe

# Then add ML dependencies
pip install onnxruntime sentence-transformers

# On Apple Silicon
pip install onnxruntime-silicon

# Initialize RAXE
raxe init

# Or specify custom location
export RAXE_CONFIG_PATH=/path/to/config.yaml

# Check current key
raxe config show | grep api_key

# Set new key
raxe config set api_key raxe_your_key_here

# Or use environment variable
export RAXE_API_KEY=raxe_your_key_here

# Get new key via browser auth
raxe auth

# Or get key from console
# https://console.raxe.ai → API Keys

# Verify rules are loaded
raxe rules list

# Check specific rule
raxe rules show pi-001

# Test with known threat
raxe scan "Ignore all previous instructions"

from raxe import Raxe

raxe = Raxe()

# Option 1: Adjust confidence threshold
result = raxe.scan(text)
high_confidence = [d for d in result.detections if d.confidence > 0.9]

# Option 2: Check specific rule causing issue
for detection in result.detections:
    print(f"{detection.rule_id}: {detection.confidence}")

from raxe import Raxe

# Increase timeout
raxe = Raxe(timeout=60.0)  # 60 seconds

# Or for very long text, chunk it
def scan_chunks(text, chunk_size=10000):
    chunks = [text[i:i+chunk_size] for i in range(0, len(text), chunk_size)]
    results = []
    for chunk in chunks:
        results.append(raxe.scan(chunk))
    return results

# Run benchmark
raxe scan "test prompt" --format json | jq '.scan_duration_ms'

# Should be <10ms for L1 only
# Should be <50ms with ML (L2)

# Disable ML for faster scans
raxe = Raxe(use_ml=False)

# Or use async for batch scanning
from raxe import AsyncRaxe

async with AsyncRaxe() as raxe:
    results = await raxe.scan_batch(prompts, concurrency=10)

# Check for other RAXE processes
ps aux | grep raxe

# Kill stuck processes
pkill -f raxe

# Or wait and retry
sleep 5 && raxe stats

# Backup current database
cp ~/.raxe/raxe.db ~/.raxe/raxe.db.backup

# Delete and reinitialize
rm ~/.raxe/raxe.db
raxe init

# Note: This loses scan history

# Test endpoint
curl -I https://api.raxe.ai/v1/telemetry

# Check endpoint config
raxe telemetry endpoint show

# Set proxy environment variables
export HTTP_PROXY=http://proxy.company.com:8080
export HTTPS_PROXY=http://proxy.company.com:8080

# Or disable telemetry (Pro+ only)
raxe telemetry disable

# Check if ML is installed
pip show onnxruntime

# Reinstall ML dependencies
pip uninstall onnxruntime sentence-transformers
pip install raxe[ml]

# Check model files
ls ~/.raxe/models/

# Disable ML for latency-sensitive paths
raxe = Raxe(use_ml=False)

# Or only use ML for flagged content
result = raxe.scan(text, use_ml=False)
if result.detections:
    # Double-check with ML
    result = raxe.scan(text, use_ml=True)

# Check if installed
pip show raxe

# Add to PATH
export PATH="$HOME/.local/bin:$PATH"

# Or run via Python
python -m raxe scan "test"

# Force color output
export FORCE_COLOR=1

# Or disable colors
export NO_COLOR=1
raxe scan "test"

# Or use JSON output
raxe scan "test" --format json

export RAXE_LOG_LEVEL=DEBUG
raxe scan "test"

raxe doctor --verbose > diagnostic.txt