Skip to content

README.linux.md

Latest commit

 

History

History
57 lines (37 loc) · 2.9 KB

README.linux.md

File metadata and controls

57 lines (37 loc) · 2.9 KB
Raw

devin-brain, Linux guide

This guide covers Linux setup only. See README.md for features, shared commands, limitations, and the safety model.

Linux uses the extended runtime: local execution plus optional Devin VM/QwenPaw delegation when this artifact supports it.

Prerequisites

  • uv and Python 3.10 or newer; uv can manage Python.

Install

Install the isolated Python CLI:

uv tool install 'devin-memory[mcp]'

Devin paths

Session data normally lives under ${XDG_DATA_HOME:-$HOME/.local/share}/devin/cli/; UI state and ACP stores under ${XDG_CONFIG_HOME:-$HOME/.config}/Devin/User/. Use --db (memory.db store) and --sessions-db for non-default locations.

Environment notes

  • Delegated runtime is optional; this guide installs local tooling only.
  • Linux can use additional compute or Linux-compatible delegated tooling when available.
  • macOS is planned but not claimed as tested.

Linux specifics

  • Installer choice: uv tool install is the recommended path (isolated environment, managed Python). pipx install works identically for PyPI packages; pip install --user is the last-resort fallback, no isolation, watch dependency conflicts.
  • PATH: executables land in ~/.local/bin. If a command is not found, add export PATH="$HOME/.local/bin:$PATH" to ~/.bashrc/~/.zshrc and open a new shell.
  • Distros: tested on Ubuntu; Debian, Fedora and Arch follow the same steps, only uv/Python acquisition differs (distro package or the uv installer script).
  • Headless and minimal environments: no display is needed, every CLI is text-only. In containers or WSL, install uv and Git and follow the same steps; XDG_* paths resolve normally.
  • Permissions: tools read Devin data under $XDG_DATA_HOME/devin and write only their own config/state, no root or sudo is required.
  • Scheduling: optional recurring work belongs to systemd --user timers or cron; installation never creates jobs.

Recurring runs (optional)

Weekly knowledge extraction from recent sessions (proposed entries, human-approved). --db pins the memory store, otherwise extract writes ./memory.db under whatever directory the scheduler runs from.

0 7 * * 0 devin-memory --db ~/devin-memory/memory.db extract --latest --sessions-db ~/.local/share/devin/cli/sessions.db

Equivalent systemd --user timer works too; enable lingering if it must run without a login session.

Troubleshooting

  • If a command is not found, ensure the uv tools directory is on PATH and run uv tool update-shell.
  • If devin-memory-mcp exits with error: The MCP server needs the 'mcp' extra (VS Code reports the server exiting with code 1), a bare devin-memory install is on PATH — uv tool install does not add extras to an existing tool. Force-reinstall with the extra: uv tool install --force 'devin-memory[mcp]' (or pipx install --force devin-memory-mcp for the shim).