🤖 AI Model Runner

Claude Code Integration Guide & API Documentation

🚀 Quick Setup Guide

⚠️ Important: Your Hugging Face Space may still be building. Once ready, the API will be available at: https://sheikhcoders-ai-model-runner.hf.space

Step 1: Locate Your Claude Code Settings

Find the settings file

The Claude Code settings file is located at:

~/.claude/settings.json

macOS/Linux: ~/.claude/settings.json

Windows: %USERPROFILE%\.claude\settings.json

Step 2: Add AI Model Runner Configuration

Basic Configuration

Add the following to your settings.json file:

{ "claude": { "api": { "endpoints": { "ai_model_runner": { "url": "https://sheikhcoders-ai-model-runner.hf.space", "description": "AI Model Runner - Code analysis, dialogue, and reasoning", "capabilities": { "code_analysis": ["explain", "refactor", "debug", "optimize"], "dialogue": "microsoft/DialoGPT-medium", "reasoning": "step-by-step problem solving", "sentiment": "text sentiment analysis" } } } } } }

Step 3: Test the Connection

Verify the API is working

Run this command to test connectivity:

curl https://sheikhcoders-ai-model-runner.hf.space/health

🛠️ Automated Setup Script

Run this script to automatically configure your Claude Code integration:

Python Script

import os import json # Create settings directory settings_dir = os.path.expanduser("~/.claude") os.makedirs(settings_dir, exist_ok=True) # Configuration config = { "claude": { "api": { "endpoints": { "ai_model_runner": { "url": "https://sheikhcoders-ai-model-runner.hf.space", "description": "AI Model Runner - Code analysis, dialogue, and reasoning" } } } } } # Save settings settings_file = os.path.join(settings_dir, "settings.json") with open(settings_file, 'w') as f: json.dump(config, f, indent=2) print(f"✅ Configuration saved to: {settings_file}")

Shell Script (Bash)

#!/bin/bash mkdir -p ~/.claude cat > ~/.claude/settings.json << 'EOF' { "claude": { "api": { "endpoints": { "ai_model_runner": { "url": "https://sheikhcoders-ai-model-runner.hf.space", "description": "AI Model Runner - Code analysis, dialogue, and reasoning" } } } } } EOF echo "✅ Configuration created at ~/.claude/settings.json"

⚙️ Advanced Configuration

Basic Endpoint Configuration

{ "claude": { "api": { "endpoints": { "ai_model_runner": { "url": "https://sheikhcoders-ai-model-runner.hf.space", "description": "AI Model Runner - All AI capabilities" } } } } }

Code Analysis Configuration

{ "claude": { "api": { "endpoints": { "ai_model_runner": { "url": "https://sheikhcoders-ai-model-runner.hf.space", "description": "AI Model Runner - Code understanding", "capabilities": { "code_analysis": { "tasks": ["explain", "refactor", "debug", "optimize"], "supported_languages": ["python", "javascript", "java", "cpp", "csharp"] } } } } } } }

Dialogue System Configuration

{ "claude": { "api": { "endpoints": { "ai_model_runner": { "url": "https://sheikhcoders-ai-model-runner.hf.space", "description": "AI Model Runner - Multi-turn dialogue", "context": { "model": "microsoft/DialoGPT-medium", "max_length": 100, "temperature": 0.7 } } } } } }

Complete Integration Configuration

{ "claude": { "api": { "endpoints": { "ai_model_runner": { "url": "https://sheikhcoders-ai-model-runner.hf.space", "description": "Complete AI Model Runner integration", "context": { "models": { "dialogue": "microsoft/DialoGPT-medium", "text_generation": "gpt2", "sentiment": "distilbert-base-uncased-finetuned-sst-2-english" }, "capabilities": { "code_analysis": { "tasks": ["explain", "refactor", "debug", "optimize"], "languages": ["python", "javascript", "java", "cpp", "csharp"] }, "dialogue": { "model": "microsoft/DialoGPT-medium", "max_length": 100, "temperature": 0.7 }, "reasoning": { "max_steps": 5 } } } } } } } }

📡 API Reference

Core Endpoints

GET

/health

Check API health and model status

Response:

{ "status": "healthy", "models_loaded": 3 }
GET

/models

List available AI models

POST

/chat

Multi-turn dialogue with AI

Request Body:

{ "messages": [ {"role": "user", "content": "Hello!"} ], "model": "microsoft/DialoGPT-medium", "max_length": 100, "temperature": 0.7 }
POST

/code

Analyze code (explain, refactor, debug, optimize)

Request Body:

{ "code": "def hello(): print('world')", "task": "explain", "language": "python" }
POST

/reasoning

Step-by-step problem solving

POST

/analyze-sentiment

Analyze text sentiment

cURL Examples

Health Check

curl https://sheikhcoders-ai-model-runner.hf.space/health

Code Analysis

curl -X POST https://sheikhcoders-ai-model-runner.hf.space/code \ -H "Content-Type: application/json" \ -d '{"code": "def hello(): return \"world\"", "task": "explain", "language": "python"}'

Chat

curl -X POST https://sheikhcoders-ai-model-runner.hf.space/chat \ -H "Content-Type: application/json" \ -d '{"messages": [{"role": "user", "content": "Hello!"}]}'

💡 Usage Examples

Python Integration Example

import requests class AIIntegrator: def __init__(self, base_url="https://sheikhcoders-ai-model-runner.hf.space"): self.base_url = base_url def health_check(self): response = requests.get(f"{self.base_url}/health") return response.json() def analyze_code(self, code, task="explain", language="python"): data = { "code": code, "task": task, "language": language } response = requests.post(f"{self.base_url}/code", json=data) return response.json() def chat(self, messages, model="microsoft/DialoGPT-medium"): data = { "messages": messages, "model": model } response = requests.post(f"{self.base_url}/chat", json=data) return response.json() # Usage integrator = AIIntegrator() # Check health print("Health:", integrator.health_check()) # Analyze code code_analysis = integrator.analyze_code( "def fibonacci(n): return [fib(i) for i in range(n)]", task="explain", language="python" ) print("Analysis:", code_analysis)

JavaScript Integration Example

class AIIntegrator { constructor(baseUrl = "https://sheikhcoders-ai-model-runner.hf.space") { this.baseUrl = baseUrl; } async healthCheck() { const response = await fetch(`${this.baseUrl}/health`); return response.json(); } async analyzeCode(code, task = "explain", language = "python") { const data = { code, task, language }; const response = await fetch(`${this.baseUrl}/code`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(data) }); return response.json(); } async chat(messages, model = "microsoft/DialoGPT-medium") { const data = { messages, model }; const response = await fetch(`${this.baseUrl}/chat`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(data) }); return response.json(); } } // Usage const integrator = new AIIntegrator(); integrator.healthCheck().then(result => { console.log("Health:", result); }); integrator.analyzeCode("console.log('Hello World')", "explain", "javascript") .then(result => { console.log("Analysis:", result); });

Claude Code Integration Script

# Claude Code Integration Script # Save as: ~/setup-claude-integration.py import os import json import shutil def setup_claude_integration(): """Setup Claude Code with AI Model Runner""" # Create settings directory settings_dir = os.path.expanduser("~/.claude") if not os.path.exists(settings_dir): os.makedirs(settings_dir) print(f"📁 Created directory: {settings_dir}") # Backup existing settings settings_file = os.path.join(settings_dir, "settings.json") if os.path.exists(settings_file): backup_file = settings_file + ".backup" shutil.copy2(settings_file, backup_file) print(f"💾 Backed up existing settings to: {backup_file}") # Load existing settings with open(settings_file, 'r') as f: settings = json.load(f) else: settings = {} # Add AI Model Runner configuration if "claude" not in settings: settings["claude"] = {} if "api" not in settings["claude"]: settings["claude"]["api"] = {} if "endpoints" not in settings["claude"]["api"]: settings["claude"]["api"]["endpoints"] = {} settings["claude"]["api"]["endpoints"]["ai_model_runner"] = { "url": "https://sheikhcoders-ai-model-runner.hf.space", "description": "AI Model Runner - Code analysis, dialogue, and reasoning", "capabilities": { "code_analysis": ["explain", "refactor", "debug", "optimize"], "dialogue": "microsoft/DialoGPT-medium", "reasoning": "step-by-step problem solving", "sentiment": "text sentiment analysis" } } # Save settings with open(settings_file, 'w') as f: json.dump(settings, f, indent=2) print(f"✅ Configuration saved to: {settings_file}") print("🚀 AI Model Runner is now integrated with Claude Code!") print(f"📡 API Endpoint: https://sheikhcoders-ai-model-runner.hf.space") if __name__ == "__main__": setup_claude_integration()

🔧 Troubleshooting

Common Issues

🚫 Space Not Loading

Issue: "Preparing Space" message persists

Solution:

  • Wait 2-5 minutes for initial build
  • Check Hugging Face Space logs
  • Verify no syntax errors in code

🔌 Connection Timeout

Issue: Requests timeout

Solution:

  • First load takes longer (model loading)
  • Check internet connection
  • Try again in a few minutes

📁 Settings File Not Found

Issue: ~/.claude/settings.json doesn't exist

Solution:

  • Create the directory: mkdir -p ~/.claude
  • Copy the configuration manually
  • Use the setup script

❌ API Returns 404

Issue: Endpoint not found

Solution:

  • Verify space URL is correct
  • Check space is fully built
  • Use correct endpoint paths

Testing Your Setup

1. Check API Health

curl https://sheikhcoders-ai-model-runner.hf.space/health

Expected response: {"status": "healthy"}

2. Test Code Analysis

curl -X POST https://sheikhcoders-ai-model-runner.hf.space/code \ -H "Content-Type: application/json" \ -d '{"code": "print(\"Hello World\")", "task": "explain"}'

3. Verify Settings File

cat ~/.claude/settings.json

Look for the "ai_model_runner" endpoint configuration

⚠️ Performance Notes

  • First Load: 30-60 seconds (model loading)
  • Subsequent Requests: 2-5 seconds (cached models)
  • Model Loading: Automatically handled on startup
  • Graceful Fallbacks: Mock responses if models fail

✅ Success Indicators

  • Health check returns "healthy" status
  • Code analysis returns detailed explanations
  • Chat responses are coherent
  • All endpoints return proper JSON

Debugging Commands

# Check space status curl -I https://sheikhcoders-ai-model-runner.hf.space/ # List available endpoints curl https://sheikhcoders-ai-model-runner.hf.space/ # Test specific endpoint curl -X GET https://sheikhcoders-ai-model-runner.hf.space/models # Check settings file ls -la ~/.claude/ cat ~/.claude/settings.json