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!
gptme is a terminal-native autonomous AI agent platform that equips language models with comprehensive tools including shell execution, Python REPL, web browsing, vision, and file manipulation. It runs anywhere a terminal runs—laptops, SSH sessions, CI pipelines—and supports creating persistent autonomous agents that can operate continuously, learn from experience through a lessons system, and coordinate with other agents. Built provider-agnostic with support for Anthropic, OpenAI, Google, xAI, DeepSeek, OpenRouter, and local models via llama.cpp, gptme also functions bidirectionally as both an MCP client and MCP server.
Key Features
Use Cases
- 01Building persistent autonomous agents that run continuously on schedules, manage tasks, and improve through lessons (like Bob)
- 02Interactive coding assistant for writing, debugging, and refactoring code with full terminal and file access
- 03CI/CD automation agent that reviews PRs, fixes tests, and validates changes in GitHub Actions pipelines
- 04Research automation combining web browsing, data collection, file processing, and analysis
- 05Multi-agent coordination with concurrent specialized agents (engineering, personal assistant) sharing infrastructure
- 06Shell command discovery and execution using natural language instead of memorizing flags and syntax
Related Agents
View morehermes-agent
The agent that grows with you
agency-agents
A complete AI agency at your fingertips - From frontend wizards to Reddit community ninjas, from whimsy injectors to reality checkers. Each agent is a specialized expert with personality, processes, and proven deliverables.
openinterpreter
A coding agent for open models like Kimi K3
cline
Autonomous coding agent as an SDK, IDE extension, or CLI assistant.
gptme — FAQ
What is gptme?+
gptme (pronounced /ʤiː piː tiː miː/) is a terminal-native AI agent platform that runs anywhere a terminal runs—your laptop, SSH sessions, tmux, headless servers, or CI pipelines. It equips language models with comprehensive tools for code execution, file manipulation, web browsing, and vision, and supports building persistent autonomous agents that operate continuously.
How do I install gptme?+
Install with pipx (recommended) using 'pipx install gptme' or with uv using 'uv tool install gptme'. Python 3.10 or newer is required. For optional features like web browsing, use 'pipx install gptme[browser]' or 'pipx install gptme[all]' for everything.
What AI providers does gptme support?+
gptme supports Anthropic (Claude), OpenAI (GPT), Google (Gemini), xAI (Grok), DeepSeek, OpenRouter (100+ models), and local models via llama.cpp. You can use API keys, subscription-based access (ChatGPT Plus/Pro or SuperGrok), or run completely local without any external service.
Which clients work with gptme?+
gptme works as a standalone CLI/TUI, web UI (chat.gptme.org), desktop app (via gptme-tauri), and integrates with Claude Desktop, Cursor, Zed, and JetBrains IDEs via MCP and ACP protocols. It can also run as an MCP server to expose its tools to any MCP-compatible client.
Is gptme free and open source?+
Yes, gptme is free and open source (available on GitHub at github.com/gptme/gptme). You only pay for the LLM provider you choose—use free models via OpenRouter, local models, or bring your own API keys/subscriptions.
How do I create autonomous agents with gptme?+
Use the gptme-agent-template to scaffold a persistent agent with workspace, task queue, run loops, and lessons system. Install as a systemd service with 'gptme service init --name my-agent' for scheduled autonomous runs. See Bob (github.com/TimeToBuildBob) for a reference implementation running continuously since late 2024.
How do I install gptme?+
Open the source repository on GitHub and follow its README. gptme is a agent — MCP Agents Market links you directly to the official repo.
Is gptme free?+
gptme is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.