LobeChat

LobeChat is an open-source, modern-design ChatGPT/LLM UI. Connect it to TensorX using the OpenAI-compatible configuration.

Prerequisites

• LobeChat installed (self-hosted or local)
• TensorX API key from app.tensorx.ai

Configuration Options

Option 1: Environment Variables (Recommended for Self-Hosted)

Set these environment variables when deploying LobeChat:

# Required
OPENAI_API_KEY=your-tensorx-api-key
OPENAI_PROXY_URL=https://api.tensorx.ai/v1

# Optional: Customize available models
OPENAI_MODEL_LIST=-all,+claude-sonnet-4-20250514,+gpt-4o,+gpt-4o-mini

Option 2: UI Configuration

1. Open LobeChat Settings (gear icon)
2. Navigate to AI Service Provider > OpenAI
3. Configure:

   • API Key: Your TensorX API key
   • API Proxy URL: https://api.tensorx.ai/v1
4. Save settings

Docker Deployment

Deploy LobeChat with TensorX configuration:

# docker-compose.yml
version: '3.8'
services:
  lobe-chat:
    image: lobehub/lobe-chat
    ports:
      - "3210:3210"
    environment:
      - OPENAI_API_KEY=your-tensorx-api-key
      - OPENAI_PROXY_URL=https://api.tensorx.ai/v1
      - OPENAI_MODEL_LIST=-all,+claude-sonnet-4-20250514,+claude-3-5-sonnet-20241022,+gpt-4o,+gpt-4o-mini

Run with:

docker-compose up -d

Vercel Deployment

When deploying to Vercel, set these environment variables in your project settings:

Variable	Value
OPENAI_API_KEY	Your TensorX API key
OPENAI_PROXY_URL	https://api.tensorx.ai/v1
OPENAI_MODEL_LIST	-all,+claude-sonnet-4-20250514,+gpt-4o,+gpt-4o-mini

Model List Configuration

The OPENAI_MODEL_LIST environment variable controls available models:

• Use +model-name to add a model
• Use -model-name to hide a model
• Use -all to disable all default models first
• Use model_name=Display Name to customize display names

Example configurations:

# Only TensorX models
OPENAI_MODEL_LIST=-all,+claude-sonnet-4-20250514,+claude-3-5-sonnet-20241022,+gpt-4o,+gpt-4o-mini

# With custom display names
OPENAI_MODEL_LIST=-all,+claude-sonnet-4-20250514=Claude Sonnet 4,+gpt-4o=GPT-4o

Available Models

See TensorX Models for all available models.

Popular choices for LobeChat:

Model	Best For
claude-sonnet-4-20250514	Complex conversations, analysis
claude-3-5-sonnet-20241022	General chat, coding assistance
gpt-4o	Multi-modal, image understanding
gpt-4o-mini	Fast responses, cost-effective

Troubleshooting

Empty responses

Check that OPENAI_PROXY_URL includes /v1 at the end.

Models not appearing

Verify OPENAI_MODEL_LIST syntax:

• Each model should be prefixed with +
• Use commas without spaces to separate models

Authentication errors

Ensure your TensorX API key is valid and has available credits.

Resources

• LobeChat Documentation
• LobeChat GitHub
• TensorX API Reference