khy-os 0.1.0

Khy OS — AI platform operating system with an extensible default app runtime

Khy OS

Khy OS is an AI platform CLI and runtime. The default built-in app is khyquant.

Positioning

• khy is the primary Khy OS command (platform shell + app runtime).
• khyquant is the default upper-layer app/plugin compatibility command.
• AI lite mode is explicit: use khy ai ... (or khy --lite ...).

Quick Start

python3 -m pip install -U khy-os
khy --help
khy doctor
khy app list

Development install:

python3 -m pip install -e .

Core Commands

khy app list
khy gateway status
khy linux status
khy server start

Explicit AI Lite Mode

khy ai "summarize this project status"
khy ai -p "only output JSON"
khy ai run qwen3.5:4b "hello"

# compatibility alias (kept for older scripts)
khy run qwen3.5:4b "hello"

OS Build Entry

bash scripts/build-khy-os.sh

Windows (Docker Desktop + PowerShell):

khy iso build --output dist/khy-os.iso
# equivalent source script:
# powershell -ExecutionPolicy Bypass -File scripts/alpine/build-iso-windows.ps1

Component mode:

bash scripts/build-khy-os.sh --component core --component vmware-plan
bash scripts/build-khy-os.sh --component moonbit --strict

WASM App Runtime

khy app register math --runtime wasm --wasm /abs/path/math.wasm --abi numeric-v1 --export add
khy app run math add 1 2

khy app register echo --runtime wasm --wasm /abs/path/echo.wasm --abi string-v2 --export run
khy app exports echo
khy app run echo hello khy os

khy app register score --runtime wasm --wasm /abs/path/score.wasm --abi json-v2 --export run
khy app run score --json '{"symbol":"AAPL","price":192.3,"rsi":63.2}'

# M1 IPC simulation (loopback netd/fsd/wmd)
khy app register weather --runtime wasm --wasm /abs/path/weather.wasm --abi json-v2 --export run --caps ipc,net
khy app ipc weather net http_get --json '{"city":"shanghai"}'

Required Environment

• Python >= 3.8
• Node.js >= 18
• Linux/macOS/Windows

Pip Distribution Boundary

• Prebuilt ISO/model artifacts are intentionally excluded from pip packages.
• You can build ISO locally after installation (khy iso build ...).
• You can download and register models on demand:

khy models pull qwen3.5:4b
khy models list
khy gateway model

See:

• docs/architecture/CORE_ARCHITECTURE.md
• docs/guides/ENV_REQUIREMENTS.md