explaingit

immrshervin/one-chat

Analysis updated 2026-05-18

11HTMLAudience · vibe coderComplexity · 1/5Setup · easy

TLDR

A single HTML file chat app that connects to local or cloud AI models with no install, build step, or server required.

Mindmap

mindmap
  root((One Chat))
    What it does
      Single file chat UI
      No install needed
      Connects local or cloud AI
    Tech stack
      HTML
      JavaScript
    Use cases
      Chat with local models
      Compare two models
      Try cloud AI providers
    Audience
      Vibe coders
      AI hobbyists

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Chat with a local AI model running in Ollama or LM Studio from a simple browser page.

USE CASE 2

Compare answers from two different AI models side by side.

USE CASE 3

Try out a cloud AI provider's API key without installing any software.

What is it built with?

HTMLJavaScript

How does it compare?

immrshervin/one-chat1000sbin/moa-goods-makerbrunosimon/esin-e1-p2026
Stars111111
LanguageHTMLHTMLHTML
Last pushed2022-05-15
MaintenanceDormant
Setup difficultyeasyeasyeasy
Complexity1/51/51/5
Audiencevibe codergeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Just download the HTML file and open it in a browser, cloud providers need their own API key.

In plain English

One Chat is a chat interface for talking to AI models, both ones running on your own computer and ones running in the cloud. Instead of switching between a different app or website for each AI provider, you open one page and connect it to whichever model you want to use. The whole application is a single HTML file, so there is nothing to install, no build step, and no server needed to run it. You just download the file and open it in a browser. It works out of the box with many providers, including local tools like Ollama and LM Studio, and cloud services like OpenAI, Google Gemini, DeepSeek, Groq, and several others, plus any service that offers an OpenAI compatible API. Local providers usually do not need an API key, while cloud providers do. Once connected, you get streaming responses that appear as they are generated, formatted text with tables and code blocks, buttons to copy responses or code, a mode to compare answers from two models side by side, and settings to adjust the system prompt, temperature, and maximum response length. You can also upload text files, JSON, Markdown, and images, save and search your chat history, export conversations, back up and restore your data, and switch between English and Persian interfaces with light and dark themes. Getting started means downloading the HTML file, opening it in a browser like Chrome, Edge, or Firefox, choosing your provider in the settings, entering the endpoint and model name and API key if one is required, testing the connection, and then chatting. Connecting to a local tool like Ollama or LM Studio just means pointing it at the local address those tools run on and picking the model you already have loaded there. On privacy, everything is stored locally in your browser and requests go directly from your browser to whichever provider you chose, without passing through any server run by the project. Your API key can be kept only for the current browser session or saved in local storage depending on a setting, and the README recommends not saving it on shared computers and leaving it out of backups for better security. The project describes itself as a simple, lightweight alternative rather than a replacement for larger, full featured AI client applications.

Copy-paste prompts

Prompt 1
Help me connect One Chat to my local Ollama installation.
Prompt 2
Explain how to set up an OpenAI compatible provider in One Chat.
Prompt 3
Walk me through using One Chat's compare mode to test two models at once.
Prompt 4
What are the privacy tradeoffs of saving my API key in One Chat's local storage?

Frequently asked questions

What is one-chat?

A single HTML file chat app that connects to local or cloud AI models with no install, build step, or server required.

What language is one-chat written in?

Mainly HTML. The stack also includes HTML, JavaScript.

How hard is one-chat to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is one-chat for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.