🚀 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:
Copy
~/.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:
Copy
{
"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
Copy
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)
Copy
#!/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"
📥 Download Setup Scripts
⚙️ Advanced Configuration
Basic Endpoint Configuration
Copy
{
"claude": {
"api": {
"endpoints": {
"ai_model_runner": {
"url": "https://sheikhcoders-ai-model-runner.hf.space",
"description": "AI Model Runner - All AI capabilities"
}
}
}
}
}
Code Analysis Configuration
Copy
{
"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
Copy
{
"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
Copy
{
"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
Copy
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
Copy
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
Copy
# 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