Operate a persistent local terminal agent with gptme
Run gptme as a terminal-first autonomous agent that can edit files, execute commands, browse the web, and keep local project context.
Prerequisites
Python, local shell, configured LLM provider, optional browser/computer-use dependencies
Installation
Use the upstream install or setup path that matches your environment:
- pipx install gptme # MCP support included by default
- pipx install 'gptme[acp]'
- pipx install gptme
- uv tool install gptme
Requirements and caveats from upstream:
- Provider-agnostic, local-first, and unconstrained: ships with shell, Python, web,
- Executes code in your local environment with the [shell][docs-tools-shell] and [python][docs-tools-python] tools.
- Simple built-in web UI included in the Python package.
Basic usage or getting-started notes:
Getting Started
🛠 Usage
Source: https://github.com/gptme/gptme
Extracted from upstream docs: https://raw.githubusercontent.com/gptme/gptme/HEAD/README.md