gptme

Your agent in your terminal, equipped with local tools: writes code, uses the terminal, browses the web. Make your own persistent autonomous agent on top!

What is gptme?

Your agent in your terminal, equipped with local tools: writes code, uses the terminal, browses the web. Make your own persistent autonomous agent on top!

Overview of gptme

What it is

gptme is a personal AI agent that runs in any terminal environment: laptop, SSH sessions, tmux, headless servers, CI pipelines. It is provider-agnostic and local-first. It ships with tools for shell, Python, web browsing, vision, and more. It is free and open-source under the MIT license. It works with Anthropic, OpenAI, Google, SpaceXAI, DeepSeek, OpenRouter, Requesty, existing ChatGPT/SuperGrok subscriptions, or fully local via Ollama and any OpenAI-compatible server.

Key features

  • Executes code in the local environment using shell and Python tools.
  • Reads, writes, and modifies files with incremental patch and morph tools.
  • Searches and browses the web via Playwright browser tool.
  • Vision capabilities: processes images, screenshots, and web pages.
  • Self-correcting: output is fed back to the assistant for iterative improvement.
  • Lessons system: contextual guidance and best practices automatically included based on keywords, tools, and patterns.
  • Cross-harness memory: a local Markdown-based memory store shared with Claude Code, Codex, and other harnesses, with CLI for save, recall, search, supersede, and audit.
  • Supports many LLM providers: Anthropic, OpenAI, Google, SpaceXAI, DeepSeek, OpenRouter, Requesty, and local models via Ollama, LM Studio, vLLM, or llama.cpp.
  • Web UI and REST API via gptme-server and gptme-webui.
  • Computer use: gives the assistant access to a full desktop for GUI interactions.
  • Code intelligence with gptme-codegraph: call graphs, symbol extraction, impact analysis via Tree-sitter.
  • Tool sounds: optional notification sounds for tool operations.

Use cases

  • Coding agent: writing code, running commands, managing files, and interacting with version control.
  • General knowledge-work: browsing the web, processing images, and automating tasks in the terminal.
  • Persistent autonomous agents: can be extended to run autonomously with custom loops and monitoring (e.g., Bob autonomous agent).
  • Development-focused alternative to Claude Code, Codex, and Grok Bot.

Getting started

Installation instructions are available in the repository README. For the TUI version, you can use:pipx install 'gptme[tui]'For other installation methods, see the repository README.

License and pricing

Licensed under MIT. Free and open-source.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/gptmegptme.svg)](https://yunodb.com/tools/gptmegptme?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/gptmegptme?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/gptmegptme.svg" alt="Featured on YunoDB" height="20"></a>