The offline library

The offline library is the public reference material ApocOS caches locally so the Library can answer from it with no Internet: man pages, RFCs, DevDocs (language/framework docs), and Wikipedia / any ZIM file. You look it up in the Library tab; you manage it here — CLI aios knowledge, or Settings → Knowledge corpora on the dashboard.

Managing corpora

aios knowledge list                  # what's installed
aios knowledge add manpages          # index this machine's man pages
aios knowledge add rfc               # the RFC archive
aios knowledge add python~3.12       # a DevDocs set by slug
aios knowledge add wikipedia.zim     # a local ZIM file
aios knowledge add <zim-url>         # download + add a ZIM
aios knowledge remove <corpus>

Finding new material (needs Internet, once)

aios knowledge catalog "python"      # browse installable Kiwix ZIMs + DevDocs sets
aios knowledge update [corpus]       # refresh installed corpora
aios knowledge sync                  # refresh everything installed

Auto-registering baked corpora

aios knowledge autoregister <dir>    # register corpora already staged on disk (used at boot)

On the ISO, corpora baked under /opt/aios/knowledge are auto-registered on first start, so search works immediately offline.

Searching

Use the Library tab in the dashboard, or just ask in Assistant — it searches your installed corpora and cites which local document an answer came from. Everything is answered from local data; nothing is fetched at query time.

Reading the full article (illustrated)

The assistant reasons over article text. To actually read a proper article — with formatting, tables and images — the dashboard offers an “Open full article” link beside each ZIM-backed result under 📚 source passages. It opens the article in a reader that renders the ZIM fully, offline.

This is why an image-rich (“maxi”) ZIM is worth its size for practical, how-to and reference material — a repair guide or first-aid page is often useless without its pictures. The reader works on any ZIM (Wikipedia, iFixit, medical references, …); a text-only (“nopic”) ZIM still renders formatting, tables and links, just no images. The reader is desktop-image only (it needs a browser) and appears only when the viewer service is running with at least one ZIM registered. The viewer service (kiwix-serve) is started for you — by aios serve on a workstation, or by a system service on an appliance — so you don’t run anything by hand; aios down stops the one aios serve started.