gptme is a Python-based CLI that acts as a local, provider-agnostic AI agent with tools for code execution, file manipulation, web browsing, vision, and autonomous run capabilities. It supports multiple LLM providers, local or remote tool access, and an extensible plugin/skills system.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
gptme is a personal AI agent that runs wherever a terminal runs. It ships with shell, Python, web, and vision tools, and can operate in autonomous or interactive modes. It supports local-only or provider-based model access and can be extended via plugins, skills, and lessons.
How it works
The project exposes built-in tools for code execution (shell, python), file edits (patch, morph, read, save, append), web access (browser via Playwright), vision (process images), and other utilities (rag, gh, tmux, computer). It includes a modular extensibility layer with Plugins, Skills, Lessons, and Hooks. It can load MCP servers for model context and supports ACP to run as a coding agent in editors.
Getting started
"pipx install gptme" is used to enable MCP support by default. "pipx install 'gptme[acp]'" enables ACP for editor integration. The README shows examples:
pipx install gptme # MCP support included by default
pipx install 'gptme[acp]'
The documentation also describes a workflow to create and run a persistent autonomous agent via the gptme-agent tool, including commands:
# Create and run your own agent
gptme-agent create ~/my-agent --name MyAgent
gptme-agent install # runs on a schedule
gptme-agent status # check on it
Recent releases
Latest releases include v0.32.2.dev20260730 (2026-07-30) and prior v0.32.1 (2026-07-17), with changelog entries noting desktop app updates and background enhancements. The README lists multiple 2026-07-20 to 2026-07-30 notes for v0.32.2.dev20260720 to v0.32.2.dev20260727. Contributors per release include @erikbjare, @TimeToBuildBob, and @eeshsaxena.
Traction
Stars: 4376
Behind the repo
The project appears under MIT license and has active development with recent pushes as of 2026-08-04. It is open-source and hosts a contributor base including named users.
Caveats
License: MIT Created: 2023-03-24 Last push: 2026-08-04 Open issues: 5 Language: Python