gptme-terminal-ai-agent-with-local-tools

name	gptme — Terminal AI Agent with Local Tools
slug	gptme-terminal-ai-agent-with-local-tools
description	gptme is an open-source Python framework for running LLM-powered agents in your terminal with access to shell commands, file editing, browser control, Python execution, and persistent memory. It supports OpenAI, Anthropic, Google Gemini, local models via Ollama and llama.cpp, and OpenRouter, making it suitable for offline, privacy-focused, or multi-provider agentic workflows. Built for autonomous operation with session persistence and tool-native agent loops.
github_stars	4355
verification	listed
source	https://github.com/gptme/gptme
author	gptme
category	Developer Tools
framework	Custom Agents
tool_ecosystem	{"github_repo":"gptme/gptme","github_stars":4355}

gptme — Terminal AI Agent with Local Tools

gptme is an open-source framework for building and running LLM-powered agents directly in your terminal. It equips agents with real local tools — shell execution, file editing, browser control, Python REPL, and persistent context — and supports multiple model providers out of the box.

Unlike browser-based AI assistants, gptme agents run natively in your environment and can read your files, run commands, browse the web, and persist state across sessions. It is designed for autonomous operation: agents can be left running, pick up work from structured task files, and chain tool calls without per-step human confirmation.

Key Features

• Multi-provider: OpenAI, Anthropic Claude, Google Gemini, OpenRouter, Ollama (local), llama.cpp, and any OpenAI-compatible endpoint
• Rich tool set: Shell (bash), file read/write/patch, Python REPL, browser automation (Playwright), computer (screenshot + click), RAG over local documents
• Persistent sessions: Conversations are stored locally; resume any session by name
• Autonomous loops: Built-in support for long-running unattended agents with structured task management and journaling
• Local-first: Works fully offline with local models; no cloud dependency required
• Extensible: MCP server support, custom tools, skill injection via gptme.toml

Installation

Install or set up from the source-backed instructions:

Install with uv tool install gptme.

• Source: https://github.com/gptme/gptme

Basic Usage

Because gptme can run shell commands, edit files, control a browser, and persist sessions locally, run it with an explicit operating boundary. Prefer a project sandbox or worktree, review enabled tool permissions before unattended runs, and avoid pointing agents at sensitive directories unless you intend those files to be inspected or modified.

# Start an interactive session
gptme "Write a Python script to list all .md files in the current dir"

# Run non-interactively (for scripting and automation)
gptme --non-interactive "Fix the failing test in tests/test_api.py"

# Use a specific provider / model
gptme -m anthropic/claude-opus-4-5 "Review the PR diff and summarize findings"

# Use a local model via Ollama
OPENAI_API_BASE= gptme -m /llama3.2 


gptme --name my-project