# Project pack: AnythingLLM @ 0acf0e8

Facts about **AnythingLLM** for an AI following the [BespokeAI handover guide](https://handoff.bespokeai.software/guide/v4.md). Pinned to one version; never changes after publication.

> AnythingLLM lets you drop in PDFs, Word files, web pages and notes, then chat with them and get answers that point back to the source. Each topic gets its own "workspace", so household paperwork, a hobby and a course stay separate. It comes with a built-in local AI and document search, so it can work without any cloud account, or you can plug in ChatGPT, Claude, Gemini or Ollama.

## Setup path (checked 2026-11-03)
- **Start here, no Docker:** Install the project's own desktop app or installer. No Docker.
- Offer Docker only if the person asks or this path fails. The commands further down may use Docker; they are not the starting point.
- Verdict source: https://raw.githubusercontent.com/Mintplex-Labs/anything-llm/HEAD/README.md
- You may be unable to download source archives or run commands in this session. The person downloads and runs things; if you cannot fetch something, give any changed file in full in chat with its path.

## Version and source
- Repository: https://github.com/Mintplex-Labs/anything-llm
- Pinned commit: `0acf0e896721d214df6a8c50282a6d118666a735`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/Mintplex-Labs/anything-llm/archive/0acf0e896721d214df6a8c50282a6d118666a735.zip
- Fresh checkout (only if you have a shell and git): use the commands below in an empty folder. If this exact source is already checked out, keep your branch and use the development command; do not clone again or reset local changes.
- Official docs: https://docs.anythingllm.com
- Licence: **MIT**. Very permissive. You can use, change and share it, even commercially, as long as you keep the copyright notice. No obligation to publish your changes.

## Commands from the pinned source
- Developer commands (they may use Docker):

  ```sh
  git clone https://github.com/Mintplex-Labs/anything-llm bespoke-anythingllm
  cd bespoke-anythingllm
  git checkout --detach 0acf0e896721d214df6a8c50282a6d118666a735
  # Prepare development requirements and local configuration first.
  # Setup notes: copies .env files and sets up Prisma; then in three terminals: yarn dev:server, yarn dev:collector, yarn dev:frontend
  yarn setup
  ```

- Separate trial of the current upstream release (not your changes; sample data and a separate data directory only):

  ```sh
  export STORAGE_LOCATION=$HOME/anythingllm && mkdir -p $STORAGE_LOCATION && touch "$STORAGE_LOCATION/.env" && docker run -d -p 3001:3001 --cap-add SYS_ADMIN -v ${STORAGE_LOCATION}:/app/server/storage -v ${STORAGE_LOCATION}/.env:/app/server/.env -e STORAGE_DIR="/app/server/storage" mintplexlabs/anythingllm # then open http://localhost:3001 and follow the setup screens
  ```
- Tools these commands use: Docker (2 GB RAM minimum, 10 GB disk recommended), or the AnythingLLM Desktop app for Mac, Windows and Linux, For development, Node.js 18 (.nvmrc) and yarn
- Develop: `yarn setup   # copies .env files and sets up Prisma; then in three terminals: yarn dev:server, yarn dev:collector, yarn dev:frontend`
- Test: `yarn test`
- Check/lint: `yarn lint`
- Stack: javascript (Node.js, Express, React, Vite, Tailwind CSS, Prisma, LanceDB). Difficulty for a non-developer with an AI: **moderate**. Three Node.js parts (server, document collector and React frontend) in plain JavaScript with Prisma on SQLite. Models, documents, agents, branding and users are all set in the app's own settings. Code changes are approachable but touch two or three folders and need yarn plus the Prisma setup step.
- The project's own AI instructions, in the repository: `CONTRIBUTING.md`.
Personal data: **yes**. Stored in: Everything lives in the storage folder you mount (STORAGE_LOCATION): the SQLite database (anythingllm.db), uploaded and processed documents, the LanceDB vector index, downloaded models, and the .env file with settings and keys. Secrets are entered by the person, never in chat.

---
Later, only when a step needs it: [reference.md](https://handoff.bespokeai.software/p/anythingllm/0acf0e8/r3/reference.md) (customisation points, must-keep-working, data and costs, coding conventions) · [hosting.md](https://handoff.bespokeai.software/p/anythingllm/0acf0e8/r3/hosting.md) (long-term hosting; hosts are paid third parties) · [bespoke.yaml](https://handoff.bespokeai.software/p/anythingllm/0acf0e8/r3/bespoke.yaml) · [SKILL.md](https://handoff.bespokeai.software/p/anythingllm/0acf0e8/r3/SKILL.md)