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.