Logo E2E Consulting
XiFan
Dev Tools

XiFan LLM Gateway
Status Ball

A macOS floating 3D status ball that monitors LLM Gateway servers in real-time. Shows model availability for MLX local models, Ollama fallback, and SiliconFlow cloud models as a draggable sphere with animated bubbles.

macOS 14+ Swift App Sandbox
Download on the Mac App Store

Features

Real-Time Monitoring

Polls your LLM Gateway every 30 seconds. Individual model health checks via /health endpoint with chat/completions fallback.

3D Status Ball

SceneKit-powered floating sphere with animated bubbles. Green = available, gray = no models, brown = disconnected. Draggable and always-on-top.

Model Categories

Automatically classifies models: MLX local, Ollama fallback (-ollama/-cloud), SiliconFlow cloud (-sf/sf/), and role aliases.

Compatible LLM Gateways

Required API Endpoints

  • GET
    /v1/models
    List available models. Polled every 30s.
  • GET
    /health?model={name}
    Individual model health check (LiteLLM native).
  • POST
    /v1/chat/completions
    Fallback health probe (max_tokens=1).
  • GET
    /siliconflow/models
    Optional. SiliconFlow cloud model listing.

Tested Gateways

  • LiteLLM Proxy
    Full support including health checks and SiliconFlow integration.
  • OpenAI-Compatible Servers
    Any server implementing the /v1/models endpoint.
  • Ollama
    Via LiteLLM proxy with -ollama/-cloud suffix convention.
  • SiliconFlow
    Via LiteLLM proxy with -sf suffix or sf/ prefix convention.

Download from the Mac App Store

XiFan LLM Gateway Status Ball is distributed exclusively through the Mac App Store. Installation takes about a minute.

Download on the Mac App Store
1

Open the Mac App Store

Click the Apple menu and choose App Store, or launch it from Launchpad / Spotlight (Cmd + Space, then type "App Store"). Sign in with your Apple ID if prompted.

2

Search for "xifan"

Type xifan into the search field in the top-left sidebar. In the results, look for XiFan LLM Gateway Status Ball in the Developer Tools category.

3

Click Get, then Install

Click the Get button (or the cloud icon if you've downloaded it before), then Install. Authenticate with Touch ID, your Apple ID password, or Apple Watch. The app is free.

4

Launch the app

Open it from Launchpad or the Applications folder. The 3D status ball will appear floating on your desktop — drag it anywhere you like, then continue with the Quick Start steps below.

System requirements: macOS 14 (Sonoma) or later. Works on both Apple Silicon and Intel Macs. The app is sandboxed and only makes network requests to the LLM Gateway you configure.

Quick Start

1

Launch the app

A floating 3D ball appears on your desktop. It runs as an accessory app with no dock icon.

2

Configure your gateway

Click the ball, then Settings. Enter your server host, port (default 4000), and API key.

3

Monitor your models

The ball turns green when models are available. Click to see the full model list with health status indicators.

Privacy Policy

XiFan-LLMGatewayStatusBall does not collect, store, or transmit any personal data. All configuration (server host, port, API key) is stored locally on your device — in macOS UserDefaults and Keychain respectively.

The app communicates only with the LLM Gateway server you configure, and no data is sent to the developer, third parties, or any external analytics services.

No cookies, tracking, or telemetry of any kind is used.

Data Storage

  • API keys are stored in the macOS Keychain (encrypted)
  • Server host, port, and preferences in local UserDefaults
  • No data is transmitted to any server other than your configured gateway
  • No analytics, crash reporting, or telemetry SDKs are included

Contact

If you have questions about this privacy policy, contact us at tech-support01@e2ec.biz

Last updated: March 29, 2026