PandaSI-Labs/littleaibox

选用指南

AI 根据 README 整理 · 2026/10/24 10:56:34

适用场景

适合需要隐私保护的对话场景，如写作、翻译、编程问答和文档阅读，支持在浏览器、PWA 和 Android 上使用。

查看 README 依据

# Little Box <p align="center"> <img src="docs/figures/hero.png" alt="Little Box" width="720"> </p> <p align="center"> <img src="public/images/favicon.svg" alt="Little Box mark" width="88"> </p> Little Box is a privacy-first conversation workspace for chat, writing, translation, coding help, and document reading. One Vite client runs in the browser, as an installed progressive web app, and inside a Capacitor Android shell. People bring their own model keys. Conversation state and parsed files stay on the device unless a feature explicitly calls the network.

目标用户

面向开发者（可附加文件提问）和需要阅读 PDF、Office 文档的用户。

查看 README 依据

| Support | [support@littleaibox.com](mailto:support@littleaibox.com) | | License | MIT, as stated in [LICENSE](LICENSE) | ```text npm install npm run dev npm run build ``` `predev` and `prebuild` run `scripts/copy-i18n.mjs` before Vite. Put model keys in the application UI. Do not commit them. ## Who it is for | Audience | What they do here | | --- | --- | | Developers | Ask coding questions with a file attached, without uploading a whole workspace | | Readers of papers and decks | Open PDF, DOCX, PPTX, and XLSX in the browser |

使用方式

通过 npm 命令安装和运行，使用 Vite 开发服务器，模型密钥在应用界面中输入。

查看 README 依据

| Support | [support@littleaibox.com](mailto:support@littleaibox.com) | | License | MIT, as stated in [LICENSE](LICENSE) | ```text npm install npm run dev npm run build ``` `predev` and `prebuild` run `scripts/copy-i18n.mjs` before Vite. Put model keys in the application UI. Do not commit them. ## Who it is for | Audience | What they do here | | --- | --- | | Developers | Ask coding questions with a file attached, without uploading a whole workspace | | Readers of papers and decks | Open PDF, DOCX, PPTX, and XLSX in the browser |

| Command | What it runs | | --- | --- | | `npm install` | Installs the client, Capacitor, and Vite toolchain | | `npm run dev` | Copies locales, then starts Vite | | `npm run build` | Copies locales, then writes `dist/` | | `npm run predev` | Locale copy only | | `npm run prebuild` | Locale copy only | There is no separate test script in `package.json`. Behavior that must stay stable is pinned by the modules cited above: origin order, store keys, entitlement numbers, cache ages, and the version compare. ## Repository map | Path | Role | | --- | --- | | `index.html` | Application shell |

部署要求

需要 Node.js 环境以运行 npm 命令，并需要用户自备模型 API 密钥。

查看 README 依据

| Support | [support@littleaibox.com](mailto:support@littleaibox.com) | | License | MIT, as stated in [LICENSE](LICENSE) | ```text npm install npm run dev npm run build ``` `predev` and `prebuild` run `scripts/copy-i18n.mjs` before Vite. Put model keys in the application UI. Do not commit them. ## Who it is for | Audience | What they do here | | --- | --- | | Developers | Ask coding questions with a file attached, without uploading a whole workspace | | Readers of papers and decks | Open PDF, DOCX, PPTX, and XLSX in the browser |

已知限制

模型调用会离开设备，并非所有请求都完全本地；免费版有字符、文档、聊天等数量限制。

查看 README 依据

| Keys live in the repository | Keys are entered in the UI and stripped from sanitized user objects | | Every request is local | Parsing and chat storage are local. Model calls still leave the device | | One host is the only host | Native and localhost API calls walk a short origin list | | A cached POST is a source of truth | POST, PUT, and DELETE to `/api/` and `/auth/` are network-only | | Office math is dropped | OMML fractions, roots, scripts, and matrices become LaTeX | | Monthly, quarterly, and yearly are different engines | Those plan codes all normalize to `pro` |

The first of those values that is set wins. Vendor modules are split into a `vendor` chunk. The chunk-size warning starts at 700 kB. ## Plan ceilings <img src="docs/figures/limits.svg" alt="Free, key, and subscription ceilings"> `src/entitlements.js` is the only place these numbers are defined. `monthly`, `quarterly`, and `yearly` all normalize to the plan code `pro`. A missing or unknown code stays unset. | Resource | Free | Custom key | Active subscription | | --- | ---: | ---: | ---: | | Characters | 50,000 | 300,000 when the key is a paid key | 300,000 |