dropbits Documentation

LLM key for operators

Dropbits does not ship or distribute free-tier API keys. The Assistant needs a bring-your-own Mistral (or compatible) key. Full primer: repository docs/LLM-KEY.md.

Server install (preferred for demos / shared hosts)

First readable non-empty file wins:

PriorityLocation
1DROPBITS_LLM_KEY_FILE (absolute path env override)
2sites/<id>/data/llm-api.key (one line; site-local)
3~/MistralPro.key or ~/Mistral.key (home file)
printf '%s\n' 'sk-…' > sites/<id>/data/llm-api.key
chmod 600 sites/<id>/data/llm-api.key

Do not commit llm-api.key, password-pepper, session-secret, or home key files.

Browser BYO (editors)

Editors can paste a key in Assistant settings (Use my Mistral API key). That stays in browser localStorage only — never written to site.db. Owner guide: LLM chat & API key.

Verify

  • Chrome / LLM modal shows server key configured (or BYO OK).
  • Optional: php tests/llm/run.php (needs a key; not default CI).
  • ./bin/site tool-run … works without any LLM key.

See also