# gptme — Terminal AI Agent with Tools & MCP

> Run an autonomous AI agent in your terminal with tool-use, MCP support, and non-interactive modes for CI. Installs via pipx/uv; Python 3.10+.

## Install

Copy the content below into your project:

## Quick Use

```bash
pipx install gptme
gptme --help

# Start an interactive session
gptme

# Non-interactive run (CI/script)
gptme -n 'run the test suite and summarize failures'
```

## Intro

gptme is a terminal-first AI agent that can run commands and use local tools, with MCP support included by default and flags for safe automation in scripts.

**Best for:** CLI-first developers, CI automation, and tool-using coding agents

**Works with:** macOS/Linux/Windows; Python 3.10+; one LLM provider key or local models

**Setup time:** 5–10 minutes

### Key facts (verified)

- Supports `-y` auto-approve and `-n` non-interactive modes (README).
- Installs via `pipx install gptme` or `uv tool install gptme` (README).
- GitHub: 4,299 stars · 388 forks; pushed 2026-05-12 (GitHub API verified).

## Main

Treat gptme as a “tool runner with a chat UI”:

- Put it in a repo and feed it structured input (`git diff`, `make test`, logs) so it can act on concrete artifacts.
- Prefer `-n` in CI so it never blocks for confirmation; use `-y` for supervised runs you can interrupt.
- If you need web access, install the optional extra (`gptme[browser]`) and validate the sandboxing policy for your environment.


### README excerpt (verbatim)

<p align="center">
  <img src="https://gptme.org/media/logo.png" width=150 />
</p>

<h1 align="center">gptme</h1>

<p align="center">
<i>/ʤiː piː tiː miː/</i>
<br>
<sub><a href="https://gptme.org/docs/misc/acronyms.html">what does it stand for?</a></sub>
</p>

<!-- Links -->
<p align="center">
  <a href="https://gptme.org/docs/getting-started.html">Getting Started</a>
  •
  <a href="https://gptme.org/downloads/">Downloads</a>
  •
  <a href="https://gptme.org/">Website</a>
  •
  <a href="https://gptme.org/docs/">Documentation</a>
</p>

<!-- Badges -->
<p align="center">
  <a href="https://github.com/gptme/gptme/actions/workflows/build.yml">
    <img src="https://github.com/gptme/gptme/actions/workflows/build.yml/badge.svg" alt="Build Status" />
  </a>
  <a href="https://github.com/gptme/gptme/actions/workflows/docs.yml">
    <img src="https://github.com/gptme/gptme/actions/workflows/docs.yml/badge.svg" alt="Docs Build Status" />
  </a>
  <a href="https://codecov.io/gh/gptme/gptme">
    <img src="https://codecov.io/gh/gptme/gptme/graph/badge.svg?token=DYAYJ8EF41" alt="Codecov" />
  </a>
  <br>
  <a href="https://pypi.org/project/gptme/">
    <img src="https://img.shields.io/pypi/v/gptme" alt="PyPI version" />
  </a>
  <a href="https://pepy.tech/project/gptme">
    <img src="https://img.shields.io/pepy/dt/gptme" alt="PyPI - Downloads all-time" />
  </a>
  <a href="https://pypistats.org/packages/gptme">
    <img src="https://img.shields.io/pypi/dd/gptme?color=success" alt="PyPI - Downloads per day" />
  </a>
  <br>
  <a href="https://discord.gg/NMaCmmkxWv">
    <img src="https://img.shields.io/discord/1271539422017618012?logo=discord&style=social" alt="Discord" />
  </a>
  <a href="https://x.com/gptmeorg">
    <img src="https://img.shields.io/twitter/follow/gptmeorg?style=social" alt="X.com" />
  </a>
  <br>
  <a href="https://gptme.org/docs/projects.html">
    <img src="https://img.shields.io/badge/powered%20by-gptme%20%F0%9F%A4%96-5151f5?style=flat" alt="Powered by gptme" />
  </a>
</p>

<p align="center">
📜 A personal AI agent that runs <i>anywhere a terminal runs</i> — your laptop,
ssh sessions, tmux, headless servers, CI pipelines.<br/>
Provider-agnostic, local-first, and unconstrained: ships with shell, Python, web,
vision, and everything else an agent needs.<br/>
A great coding agent, but general-purpose enough to assist in all kinds of knowledge-work.
</p>

<p align="center">
Free and open-source. Works with Anthropic, OpenAI, Google, xAI, DeepSeek, OpenRouter,
or fully local via <code>llama.cpp</code> — your data, your models, your terminal.<br/>

### FAQ

**Q: Does gptme include MCP support?**
A: README states MCP support is included by default; you can add extras for more capabilities.

**Q: What Python version is required?**
A: Prerequisites list Python 3.10 or newer.

**Q: How do I make it safe for CI?**
A: Use `-n` for fully non-interactive runs, and consider `-y` only when a human can monitor and interrupt.

## Source & Thanks

> Source: https://github.com/gptme/gptme
> License: MIT
> GitHub stars: 4,299 · forks: 388

---

<!-- ZH -->

## 快速使用

```bash
pipx install gptme
gptme --help

# 进入交互式会话
gptme

# 非交互运行（CI/脚本）
gptme -n '运行测试并总结失败原因'
```

## 简介

gptme 是一个以终端为中心的 AI Agent：能执行命令、使用本地工具，并默认支持 MCP；同时提供适合脚本化自动化的运行模式。

**最适合：** 偏好命令行的开发者、CI 自动化、需要工具调用的编码 Agent

**适配：** macOS/Linux/Windows；Python 3.10+；可用任一模型提供方 Key 或本地模型

**配置时间：** 5–10 分钟

### 关键事实（已验证）

- 支持 `-y` 自动确认与 `-n` 非交互模式（README）。
- 可用 `pipx` 或 `uv tool` 安装（README）。
- GitHub：4,299 stars · 388 forks；最近更新 2026-05-12（GitHub API 验证）。

## 正文

把 gptme 当作“带对话界面的工具执行器”更顺手：

- 在代码仓库里给它结构化输入（`git diff`、`make test`、日志），它更容易做出可执行的修改建议。
- CI 场景优先用 `-n`，避免等待确认；人工监督时用 `-y` 并随时打断。
- 需要网页访问时再安装可选 extra（`gptme[browser]`），并结合你的环境校验沙箱/权限策略。


### README 原文节选（verbatim）

<p align="center">
  <img src="https://gptme.org/media/logo.png" width=150 />
</p>

<h1 align="center">gptme</h1>

<p align="center">
<i>/ʤiː piː tiː miː/</i>
<br>
<sub><a href="https://gptme.org/docs/misc/acronyms.html">what does it stand for?</a></sub>
</p>

<!-- Links -->
<p align="center">
  <a href="https://gptme.org/docs/getting-started.html">Getting Started</a>
  •
  <a href="https://gptme.org/downloads/">Downloads</a>
  •
  <a href="https://gptme.org/">Website</a>
  •
  <a href="https://gptme.org/docs/">Documentation</a>
</p>

<!-- Badges -->
<p align="center">
  <a href="https://github.com/gptme/gptme/actions/workflows/build.yml">
    <img src="https://github.com/gptme/gptme/actions/workflows/build.yml/badge.svg" alt="Build Status" />
  </a>
  <a href="https://github.com/gptme/gptme/actions/workflows/docs.yml">
    <img src="https://github.com/gptme/gptme/actions/workflows/docs.yml/badge.svg" alt="Docs Build Status" />
  </a>
  <a href="https://codecov.io/gh/gptme/gptme">
    <img src="https://codecov.io/gh/gptme/gptme/graph/badge.svg?token=DYAYJ8EF41" alt="Codecov" />
  </a>
  <br>
  <a href="https://pypi.org/project/gptme/">
    <img src="https://img.shields.io/pypi/v/gptme" alt="PyPI version" />
  </a>
  <a href="https://pepy.tech/project/gptme">
    <img src="https://img.shields.io/pepy/dt/gptme" alt="PyPI - Downloads all-time" />
  </a>
  <a href="https://pypistats.org/packages/gptme">
    <img src="https://img.shields.io/pypi/dd/gptme?color=success" alt="PyPI - Downloads per day" />
  </a>
  <br>
  <a href="https://discord.gg/NMaCmmkxWv">
    <img src="https://img.shields.io/discord/1271539422017618012?logo=discord&style=social" alt="Discord" />
  </a>
  <a href="https://x.com/gptmeorg">
    <img src="https://img.shields.io/twitter/follow/gptmeorg?style=social" alt="X.com" />
  </a>
  <br>
  <a href="https://gptme.org/docs/projects.html">
    <img src="https://img.shields.io/badge/powered%20by-gptme%20%F0%9F%A4%96-5151f5?style=flat" alt="Powered by gptme" />
  </a>
</p>

<p align="center">
📜 A personal AI agent that runs <i>anywhere a terminal runs</i> — your laptop,
ssh sessions, tmux, headless servers, CI pipelines.<br/>
Provider-agnostic, local-first, and unconstrained: ships with shell, Python, web,
vision, and everything else an agent needs.<br/>
A great coding agent, but general-purpose enough to assist in all kinds of knowledge-work.
</p>

<p align="center">
Free and open-source. Works with Anthropic, OpenAI, Google, xAI, DeepSeek, OpenRouter,
or fully local via <code>llama.cpp</code> — your data, your models, your terminal.<br/>

### FAQ

**gptme 自带 MCP 吗？**
答：README 表示默认包含 MCP 支持；也可以按需安装 extra 扩展能力。

**需要什么 Python 版本？**
答：Prerequisites 写明需要 Python 3.10 或更高版本。

**怎么用于 CI 更安全？**
答：使用 `-n` 让流程完全非交互；有人监督时再考虑 `-y`。

## 来源与感谢

> Source: https://github.com/gptme/gptme
> License: MIT
> GitHub stars: 4,299 · forks: 388


---
Source: https://tokrepo.com/en/workflows/gptme-terminal-ai-agent-with-tools-mcp
Author: Script Depot