abonaie222263/model-hub-chat
0
Model Hub Chat ๐ฌ
A professional, macOS-style chat app where you can talk to any model โ either running entirely in your browser (free CPU, private, no account) or through any OpenAI-compatible endpoint (Hugging Face Inference Providers, opencode, Hermes, โฆ).
Features
- ๐ง In-browser inference โ 8 curated models run locally via transformers.js (ONNX/WASM). Zero servers, zero cost, 100% private.
- ๐ Remote API mode โ stream tokens from any
/v1/chat/completionsendpoint, with curated HF-hosted presets (openai/gpt-oss-20b,Qwen/Qwen2.5-72B-Instruct,DeepSeek-V3, โฆ) and custom base URLs. - โ๏ธ Full settings page โ completion endpoint (base URL + API key + model), system prompt, temperature / max tokens / top-p, plus quick sliders right above the composer.
- ๐ Bring-your-own token โ paste an HF token (or pass
?hf_token=โฆ) to use its credits on hosted models. - ๐ค opencode / Hermes integration โ the Settings page generates a ready-to-paste
opencode.jsonprovider config plus the raw endpoint URL. - ๐ฅ macOS-style UI โ traffic-light title bar, sidebar, clean typography.
Models
In-browser (free, private)
Remote API (HF Inference Providers, your token)
openai/gpt-oss-20b(default)Qwen/Qwen2.5-72B-Instructmeta-llama/Llama-3.3-70B-Instructdeepseek-ai/DeepSeek-V3mistralai/Mistral-Nemo-Instruct-2407HuggingFaceH4/zephyr-7b-beta(free tier)
Why this approach?
A Static Space was chosen because free accounts can't host a server-side Gradio/Docker Space (needs PRO), and the visitor-pays OAuth pattern needs an OAuth app. This Space works for everyone immediately:
- No server, no quota โ in-browser inference uses the visitor's own CPU.
- Optional API โ connect any OpenAI-compatible endpoint for bigger models.
Usage
- Open the app.
- Pick a model (Models tab) or switch to API mode.
- Tune the system prompt / endpoint / generation in Settings.
- Chat.
Connect opencode / Hermes
In Settings, copy the generated endpoint URL or the opencode.json config. Example:
{
"provider": "modelhub",
"base_url": "https://router.huggingface.co/v1/chat/completions",
"api_key": "<YOUR_HF_TOKEN>",
"model": "openai/gpt-oss-20b",
"chat": { "temperature": 0.7, "max_tokens": 512, "top_p": 0.95 }
}License / credits
UI and code: MIT. Models keep their own licenses (Apache 2.0, MIT, Llama 3.2, Gemma). Built with transformers.js.
