# Project pack: InvenTree @ d11b74f

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

> InvenTree is an inventory system for parts and stock. You define parts with categories and parameters, track stock locations and quantities, manage suppliers and purchase orders, and build assemblies from bills of materials. It has a plugin system, an API and barcode label support, and suits workshops, electronics hobbyists and makerspaces.

## Setup path (checked 2026-11-03)
- **Needs Docker.** Tell the person before any setup work; no light non-Docker route is documented upstream. Docker Desktop on Windows may need a computer restart and an admin-only Windows feature (virtualisation); say so and let the person decide.
- Verdict source: https://docs.inventree.org
- 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/inventree/InvenTree
- Pinned commit: `d11b74fd857a6ebf47658b707605a64a10be764f`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/inventree/InvenTree/archive/d11b74fd857a6ebf47658b707605a64a10be764f.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.inventree.org
- Live demo: https://inventree.org/demo. Official demo instance. Don't enter real data.
- Licence: **MIT**. Free to use, change and share, even commercially. Keep the original copyright notice.

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

  ```sh
  git clone https://github.com/inventree/InvenTree bespoke-inventree
  cd bespoke-inventree
  git checkout --detach d11b74fd857a6ebf47658b707605a64a10be764f
  # Prepare development requirements and local configuration first.
  pip install invoke
  invoke dev.setup-dev
  invoke dev.server
  ```

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

  ```sh
  Follow the Docker guide at https://docs.inventree.org/en/stable/start/docker, which provides the docker-compose.yml, env file and Caddy proxy.
  ```
- Tools these commands use: Docker for a trial, Python 3.11 and Node 22 for development
- Develop: `invoke dev.server`
- Test: `invoke dev.test`
- Check/lint: `invoke dev.lint`
- Stack: python, typescript (Django, Django REST Framework, React, Mantine, Vite). Difficulty for a non-developer with an AI: **advanced**. A mature Django and React project with a plugin system. Most customisation is parameters, categories and plugins; deeper changes involve the full stack.
- The project's own AI instructions, in the repository: `AGENTS.md`, `CLAUDE.md`.
Personal data: **no**. Stored in: A database plus a media folder for images and attachments. Secrets are entered by the person, never in chat.

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