---
name: "Operate a persistent local terminal agent with gptme"
slug: "operate-a-persistent-local-terminal-agent-with-gptme"
description: "Run gptme as a terminal-first autonomous agent that can edit files, execute commands, browse the web, and keep local project context."
github_stars: 4353
verification: "security_reviewed"
source: "https://github.com/gptme/gptme"
author: "gptme"
publisher_type: "organization"
category: "Developer Tools"
framework: "Custom Agents"
tool_ecosystem:
  github_repo: "gptme/gptme"
  github_stars: 4353
---

# 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:
- <a href="https://gptme.org/docs/getting-started.html">Getting Started</a>
- 🚀 [Getting Started](#-getting-started)
- 🛠 [Usage](#-usage)

- Source: https://github.com/gptme/gptme
- Extracted from upstream docs: https://raw.githubusercontent.com/gptme/gptme/HEAD/README.md

## Documentation

- https://gptme.org/docs/

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/operate-a-persistent-local-terminal-agent-with-gptme/)