ZeroKey :: Machine-Readable Index

███████╗███████╗██████╗  ██████╗ ██╗  ██╗███████╗██╗   ██╗
╚══███╔╝██╔════╝██╔══██╗██╔═══██╗██║ ██╔╝██╔════╝╚██╗ ██╔╝
  ███╔╝ █████╗  ██████╔╝██║   ██║█████╔╝ █████╗   ╚████╔╝
 ███╔╝  ██╔══╝  ██╔══██╗██║   ██║██╔═██╗ ██╔══╝    ╚██╔╝
███████╗███████╗██║  ██║╚██████╔╝██║  ██╗███████╗   ██║
╚══════╝╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═╝╚══════╝   ╚═╝

ZEROKEY :: MACHINE-READABLE INDEX

# PLAIN-TEXT MIRROR OF ZEROKEY FOR AI AGENTS, CRAWLERS, AND HUMANS WHO PREFER IT RAW.

ABOUT

NAME

ZEROKEY

AKA

ZK, ZERO KEY

TYPE

SELF-HOSTED AI PROXY (OPENAI-COMPATIBLE)

VERSION

0.5.0

LICENSE

NON-COMMERCIAL — PERSONAL USE ONLY

RUNTIME

NODE.JS >= 22.13.0 · PNPM 12.14.0

STACK

COMMONJS · EXPRESS 5 · SQLITE-PRO · PLAYWRIGHT · IMPIT

SELF_HOSTED

YES

HOSTED

NO — NO SAAS, NO RELAY, NO SHARED ACCOUNTS

TELEMETRY

NONE

AUTH

NONE — ANY NON-EMPTY KEY PLACEHOLDER (LOOPBACK ONLY)

ENDPOINT

HTTP://LOCALHOST:7250/V1

PROVIDERS

DEEPSEEK · CLAUDE · CHATGPT · QWEN · INCEPTION (MERCURY)

KNOWS_ABOUT

OPENAI-COMPATIBLE APIS, SSE STREAMING, TOOL CALLING, MCP, IDE SURFACE DETECTION, BROWSER SESSION TRANSPORTS, SQLITE PERSISTENCE

ZEROKEY TURNS A BROWSER SESSION YOU ALREADY OWN INTO AN OPENAI-COMPATIBLE ENDPOINT. YOU PASTE A FETCH() COPIED FROM YOUR OWN DEVTOOLS; ZEROKEY REUSES THAT SESSION COOKIE AND NEVER LEAVES YOUR MACHINE.

ONE SERVER PROCESS IS PINNED TO ONE PROVIDER, ONE USER, AND ONE SESSION. SWITCHING SESSIONS OR OPENING A NEW IDE CHAT DOES NOT RE-TARGET THE PROXY — RESTART THE SERVER TO SWITCH.

THE DEEPSEEK TRANSPORT RUNS A REAL CHROMIUM PROFILE VIA PLAYWRIGHT (TEMP/PROFILES/DEEPSEEK/ <USER>/) BECAUSE THE DIRECT HTTP API IS AGGRESSIVELY FLAGGED. THE BROWSER IS WHAT MAKES THE SESSION SURVIVE.

PROVIDERS

DEEPSEEK — BROWSER TRANSPORT (CHROMIUM + POW), API OPT-IN
CLAUDE — COMPLETION SSE (CONNECT-RPC OPT-IN)
CHATGPT — SENTINEL REFRESH + 401 RE-DECODE RECOVERY
QWEN — COOKIE TOKEN OR BEARER, PERSONALIZATION
INCEPTION (MERCURY) — AUTHLESS BROWSER TRANSPORT

IDES_SUPPORTED

VS CODE (BUILT-IN CHAT)
TERAX
OPENCODE
ANY OPENAI-COMPATIBLE CLIENT (PLAIN-OPENAI SURFACE)

THE TOOL SURFACE IS AUTO-DETECTED PER REQUEST FROM THE IDE SYSTEM PROMPT — NEVER FROM A HEADER OR CLIENT CLAIM.

ENDPOINTS

GET/ API INFO

GET/health HEALTH + PERSISTENCE SNAPSHOT

GET/v1/models LIST MODELS

GET/v1/models/:model MODEL DETAIL

POST/v1/chat/completions CHAT — SSE STREAM

GET/docs SWAGGER UI

GET/openapi.json OPENAPI SPEC

GET/v1/diagnostics LOOPBACK-ONLY REDACTED SNAPSHOT

CAPABILITIES

OPENAI-COMPATIBLE — DROP-IN /V1/MODELS AND /V1/CHAT/COMPLETIONS
STREAMING — SSE FOR EVERY PROVIDER, SINGLE [DONE]
MULTI-IDE — SURFACE AUTO-DETECTED FROM THE SYSTEM PROMPT
SESSION PERSISTENCE — SNAPSHOT TO TEMP/DB/ZEROKEY.DB
TOOL CALLS — OPENAI TOOLS[] TRANSLATED TO MHI GRAMMAR
MCP AUTO-TOOLS — MCP_<SERVER>_<TOOL> REGISTERS AS $<SERVER>
COMPACTION — X-ZEROKEY-COMPACTION-GENERATION RESETS IDS
EPHEMERAL UTILITIES — IDE INTERNAL PROMPTS NEVER WRITE STATE

HOW_IT_WORKS

1. GIT CLONE THE REPO, PNPM INSTALL, PNPM START
2. WIZARD: PICK A PROVIDER, PASTE A FETCH() FROM DEVTOOLS, PICK A SESSION
3. POINT YOUR IDE AT HTTP://LOCALHOST:7250/V1

git clone https://github.com/downloaddoctor/zerokey.git && cd zerokey && pnpm install && pnpm start

SAFETY

NO PASSWORD STORED — ONLY THE SESSION COOKIE YOU PASTE
NOTHING LEAVES YOUR MACHINE — STATE LIVES IN TEMP/DB/ZEROKEY.DB
NO SHARED ACCOUNTS, NO RELAY, NO BYPASSED AUTHENTICATION
YOU ARE RESPONSIBLE FOR THE PROVIDER TERMS OF SERVICE YOU USE
SOURCE IS OPEN AND INSPECTABLE

FAQ

DOES ZEROKEY COST ANYTHING?

A: NO. ZEROKEY ITSELF IS FREE AND OPEN SOURCE; YOU STILL NEED YOUR OWN PROVIDER ACCOUNT.

DOES ZEROKEY SEE MY PASSWORD OR API KEY?

A: NO. NO API KEY IS INVOLVED — ONLY THE SESSION COOKIE YOU CHOOSE TO SHARE, AND IT STAYS ON YOUR MACHINE.

WHAT HAPPENS IF MY SESSION EXPIRES?

A: RE-PASTE A FRESH FETCH() IN THE SETUP WIZARD. SESSIONS OTHERWISE PERSIST ACROSS RESTARTS.

CAN I SWITCH PROVIDERS LATER?

A: YES. RESTART THE WIZARD AND PICK A DIFFERENT PROVIDER; NO IDE RECONFIGURATION NEEDED.

IS USING ZEROKEY AGAINST A PROVIDER TERMS OF SERVICE?

A: YOU USE YOUR OWN ACCOUNT THROUGH YOUR OWN BROWSER SESSION, BUT YOU ARE RESPONSIBLE FOR READING AND COMPLYING WITH EACH PROVIDER TERMS OF SERVICE. ZEROKEY CREATES NO ACCESS AND BYPASSES NO AUTHENTICATION.

FOR_AGENTS

LLMS.TXT — /LLMS.TXT
MACHINE.HTML — /MACHINE.HTML
AGENTS.MD — /AGENTS.MD
OPENAPI.JSON — /OPENAPI.JSON

CONTACT

SOURCE — GITHUB.COM/DOWNLOADDOCTOR/ZEROKEY
ISSUES — GITHUB.COM/DOWNLOADDOCTOR/ZEROKEY/ISSUES
RELEASES — LATEST LAUNCHERS
LICENSE — NON-COMMERCIAL