Reference guide and technical documentation to get the most out of your portable, private AI client.
ZeroChat is a standalone, secure, and portable web client designed to interact with artificial intelligence models, orchestrate autonomous multi-turn agents, and search local document knowledge bases.
Unlike conventional web apps, ZeroChat is served as a static web application (zerochat.html) that runs directly on GitHub Pages or any static web server with no heavy dependencies, database backends, or proxies. All your personal data, chat histories, profile credentials, and indexed documents remain strictly on your machine within your browser.
zerochat.py.
zerochat.html (Direct Web / PWA): Opens directly in any desktop or mobile browser (specifically optimized for Android as an installable PWA). By default it uses dark mode and, on mobile, keeps the conversation panel closed to prioritize the chat; both can be changed from the interface controls. Delivers commercial or local inference (WebLLM/WebGPU), in-browser RAG knowledge bases (Orama), Agent mode with a secure JS sandbox, and private IndexedDB storage without requiring Python, a terminal, or installation.
zerochat.py (Local with Python backend): Background local server (port 6388 with a secure ephemeral token). Extends the web app with host operating system control: reading and editing local project files, executing terminal commands, and connecting external MCP servers (Playwright, LSP, memory).
Install the official executable from PyPI; it opens the GitHub Pages interface with a secure local session. PyPI and the direct download use the same ~/zerochat/ directory for state and MCP services.
pip install zerochat && zerochatDirect alternative: download zerochat.py and run it with Python.
Download zerochat.py: zerochat.py
Run it directly (curl):
curl -sL https://albalday.github.io/zerochat/zerochat.py -o zerochat.py && python3 zerochat.pyDelete ~/zerochat/ to remove configuration, token, MCP services, and their dependencies without removing the installed or downloaded executable.
Explore each ZeroChat component below. Click any card to read its detailed technical guide: