---
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`.