{"slug":"docs","name":"Chat with your files","kind":"recipe","what":"A private chat that answers questions about your own PDFs, notes and documents.","page":"https://insidethemachine.ai/do/docs","status":"partly-ran","status_label":"Partly checked: some paths were run, the rest only checked against docs","status_note":"Install steps run on an Apple M4 Mac with 16 GB on 2026-10-15. File upload and the first Docling run are checked against the docs only.","wrapper":"The wrapper scripts are generated from the site data. Every .sh passed bash -n and shellcheck and ran in plan mode on Linux (Debian 13). Every .ps1 passed the PowerShell parser and chat.ps1 ran in plan, verify and rollback mode under PowerShell 7 on Linux with Windows calls mocked. Not run on macOS or real Windows.","wrapper_tested":null,"sh":"https://insidethemachine.ai/install/docs.sh","ps1":"https://insidethemachine.ai/install/docs.ps1","md":"https://insidethemachine.ai/install/docs.md","json":"https://insidethemachine.ai/install/docs.json","one_liner":"curl -fsSL https://insidethemachine.ai/install/docs.sh | bash","one_liner_windows":"irm https://insidethemachine.ai/install/docs.ps1 | iex","actions":{"install":"curl -fsSL https://insidethemachine.ai/install/docs.sh | bash","plan":"curl -fsSL https://insidethemachine.ai/install/docs.sh | bash -s -- plan","verify":"curl -fsSL https://insidethemachine.ai/install/docs.sh | bash -s -- verify","rollback":"curl -fsSL https://insidethemachine.ai/install/docs.sh | bash -s -- rollback --yes"},"env":{"ITM_RAM":"memory in GB instead of detecting it","ITM_MODEL":"ollama tag to use instead of the pick"},"model_by_memory_gb":{"8":"qwen3.5:4b","16":"gemma4:12b","24":"gemma4:12b","32":"qwen3.8:27b","48":"qwen3.8:27b","64":"qwen3.8:27b","96":"qwen3.8:27b","128":"qwen3.8:27b","192":"qwen3.8-flash-next:125b-a6b","256":"qwen3.8-flash-next:125b-a6b","512":"qwen3.8-flash-next:125b-a6b"},"low_memory":null,"platforms":{"macos":{"install":[{"title":"Install Ollama","lines":[{"k":"run","c":"curl -fsSL https://ollama.com/install.sh | sh"}]},{"title":"Download your model","lines":[{"k":"ollama","c":"ollama pull $MODEL"}]},{"title":"Add a ChatGPT-style window","lines":[{"k":"mac","c":"brew install python@3.11"},{"k":"run","c":"python3.11 -m venv ~/.venvs/openwebui && source ~/.venvs/openwebui/bin/activate"},{"k":"run","c":"pip install open-webui"},{"k":"you","c":"open-webui serve","why":"starts a server that keeps running; run it in its own window"}]},{"title":"Add your files","lines":[{"k":"note","c":"In a chat, click + and attach a file, then ask about it. For a whole folder, go to Workspace → Knowledge, make a collection and upload your files. Then type # in a chat to use it."}]},{"title":"Messy PDF? Clean it first","lines":[{"k":"run","c":"python3 -m venv ~/.venvs/docling && source ~/.venvs/docling/bin/activate"},{"k":"run","c":"pip install docling"},{"k":"you","c":"docling yourfile.pdf","why":"needs your own file, folder or model name"}]}],"verify":[{"run":"ollama --version","expect":"a version number"},{"run":"ollama list | grep -F \"${MODEL%%:*}\"","expect":"your model is in the list"},{"run":"test -x ~/.venvs/openwebui/bin/open-webui","expect":"Open WebUI is installed"},{"run":"test -x ~/.venvs/docling/bin/docling","expect":"Docling is installed"}],"rollback":[{"k":"ollama","c":"ollama rm $MODEL"},{"k":"run","c":"rm -rf ~/.venvs/openwebui ~/.venvs/docling"},{"k":"run","c":"rm -rf ~/Library/Caches/pip"}]},"linux":{"install":[{"title":"Install Ollama","lines":[{"k":"run","c":"curl -fsSL https://ollama.com/install.sh | sh"}]},{"title":"Download your model","lines":[{"k":"ollama","c":"ollama pull $MODEL"}]},{"title":"Add a ChatGPT-style window","lines":[{"k":"mac","c":"brew install python@3.11"},{"k":"run","c":"python3.11 -m venv ~/.venvs/openwebui && source ~/.venvs/openwebui/bin/activate"},{"k":"run","c":"pip install open-webui"},{"k":"you","c":"open-webui serve","why":"starts a server that keeps running; run it in its own window"}]},{"title":"Add your files","lines":[{"k":"note","c":"In a chat, click + and attach a file, then ask about it. For a whole folder, go to Workspace → Knowledge, make a collection and upload your files. Then type # in a chat to use it."}]},{"title":"Messy PDF? Clean it first","lines":[{"k":"run","c":"python3 -m venv ~/.venvs/docling && source ~/.venvs/docling/bin/activate"},{"k":"run","c":"pip install docling"},{"k":"you","c":"docling yourfile.pdf","why":"needs your own file, folder or model name"}]}],"verify":[{"run":"ollama --version","expect":"a version number"},{"run":"ollama list | grep -F \"${MODEL%%:*}\"","expect":"your model is in the list"},{"run":"test -x ~/.venvs/openwebui/bin/open-webui","expect":"Open WebUI is installed"},{"run":"test -x ~/.venvs/docling/bin/docling","expect":"Docling is installed"}],"rollback":[{"k":"ollama","c":"ollama rm $MODEL"},{"k":"run","c":"rm -rf ~/.venvs/openwebui ~/.venvs/docling"},{"k":"run","c":"rm -rf ~/Library/Caches/pip"}]},"windows":{"install":[{"title":"Install Ollama","lines":[{"k":"run","c":"irm https://ollama.com/install.ps1 | iex"}]},{"title":"Download your model","lines":[{"k":"ollama","c":"ollama pull $MODEL"}]},{"title":"The rest of the recipe","lines":[{"k":"note","c":"Install Ollama with this PowerShell command, or the installer from ollama.com/download. On Linux, the install command above works as it is. After that, every ollama command on this page is the same. Open WebUI and Docling also run on Windows; their pages have the steps. Steps: https://insidethemachine.ai/do/docs"}]}],"verify":[{"run":"ollama --version","expect":"a version number"},{"run":"ollama list","expect":"your model is in the list"}],"rollback":[{"k":"ollama","c":"ollama rm $MODEL"}]}}}