README.md

metadata

title: DOS LLM
emoji: 💾
colorFrom: green
colorTo: blue
sdk: static
pinned: false
short_description: Ask an LLM in Chinese or English from inside FreeDOS

DOS LLM — ask an AI from inside DOS (中文 / English)

Type a question, press the button: a FreeDOS machine (v86 x86 emulator, in your browser) runs G <question>. G.EXE is a real DOS program that does its own DNS, TCP and HTTP through an emulated NE2000 card and calls a public Gradio Space (default tencent/Hy3) with Gradio's documented API. The answer is printed on the DOS screen.

1. POST /gradio_api/call/chat with the question -> event_id
2. GET /gradio_api/call/chat/<event_id> -> server-sent events (generating ... complete)
3. G.EXE decodes the complete frame and prints it as A> ...

The page then compares the text printed on the DOS screen with the text Gradio returned and shows DOS = LLM when they are identical.

How the packets leave the browser

Inside DOS: Crynwr NE2000 packet driver -> mTCP DHCP.EXE (192.168.86.100) -> G.EXE (mTCP TCP/IP stack). DOS has no TLS and browsers cannot open raw TCP, so v86 terminates the guest's TCP streams and bridge.js (a tiny in-page WISP server) turns each HTTP request DOS sends on port 80 into an HTTPS fetch(). It relays only *.hf.space hosts and paths starting with /gradio_api/ (GET/POST, body <= 8 KB, no credentials), so it is not an open proxy. DNS is answered by v86 using DNS-over-HTTPS.

Things to know

• Chinese and English both work. DOS runs 小貓中文 (Big5 display + Zhuyin input), so the question and the answer are shown in Chinese on the DOS screen; type in DOS with Ctrl+Space (注音). Characters Big5 does not have (Simplified Chinese, emoji) show as ?; Chinese questions ask the model for Traditional Chinese. Replies are limited to ~40 words / ~80 Chinese characters.
• The DOS screen is 640x400 (XiaoMao). The page presents it in device pixels, 4:3 like a real VGA monitor by default, sharp on HiDPI screens; the card has a zoom selector (fit width / integer / 2x scrollable) and a 4:3 checkbox.
• 小貓中文 v1.0 — author HelloSun, first version 2026-10-25. It prints its notice every time it loads in DOS, TYPE AUTHOR.TXT shows the licence terms. Please keep the author notice (see LICENSE).
• The Big5 <-> UTF-8 conversion happens in the page (big5.js); DOS only ever sees Big5.
• Your question is sent to the chosen public Space (it is a third-party service). Do not type secrets.
• If DOS ever hangs, press 重新開機 (reboot). Another Space can be tried under "進階" if it exposes a /chat endpoint with the same 9 parameters as tencent/Hy3.
• Needs a modern browser (WebAssembly, DecompressionStream) and internet access.

Developer package

dev/dosllm-dev.zip has the sources, build scripts, tests and the handover document dev/HANDOFF.md; it also contains the mTCP source archive that G.EXE is linked against and the unmodified 小貓中文 package. Rebuild everything with tools/build_all.sh. Our code is GPL-3.0-or-later. 小貓中文 is by HelloSun (v1.0, 2026-10-25): GPL-3.0-only plus a GPLv3 §7(b) term: the author attribution must be kept; see LICENSE and NOTICE.md.