LibreAI / Dev Tools / gptme
// devtools · gptme/gptme

gptme

gptme is a terminal AI agent with shell, files, browser, vision, and subagents — provider-agnostic

★ 4.4k stars⑂ 449 forksMITupdated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

gptme is an open-source dev tools project by gptme (gptme/gptme on GitHub). It has 4,443 GitHub stars and 449 forks, is released under the MIT license, and was last updated on GitHub on 8 October 2026.

Repository
gptme/gptme
GitHub stars
4,443
Forks
449
License
MIT
Last updated on GitHub
8 October 2026
Category
Dev Tools
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Choose a model provider

    Pick a cloud provider key, a subscription login, or a local Ollama/OpenAI-compatible server.

  2. Install gptme

    Install with pipx (adding extras like [tui] if you want the richer terminal UI).

  3. Configure access

    Set your provider credentials as documented, or point gptme at your local model server.

  4. Start a session

    Launch gptme in a project directory and give it a real task — it will plan, run tools, and verify results.

// features

Why people love it

Full tool belt built in

Shell, IPython, file editing/patching, browser, vision, screenshots, GitHub, tmux, and subagents without extra setup.

Provider-agnostic

Anthropic, OpenAI, Google, xAI, DeepSeek, OpenRouter, subscription logins, or fully local models.

Lessons and memory

A lessons system encodes corrections so mistakes are not repeated; Markdown memory is shared across harnesses (Claude Code, Codex).

MCP both ways

Use any MCP server from gptme, and expose gptme itself as an MCP server (gptme-mcp-server).

Editor and server modes

ACP integration for Zed/JetBrains, plus a web UI and REST server, beyond the terminal.

Runs anywhere a terminal does

Works over ssh, inside tmux, in CI, and as a persistent autonomous agent using the agent template.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Clone the project and enter its directory (most users install with pipx, next step).

    git clone https://github.com/gptme/gptme.git
    cd gptme
  2. Install with pipx

    Install gptme (add extras such as [tui] for the terminal UI if desired).

    pipx install gptme
  3. Start your agent

    Set your provider key (or start a local Ollama server) and launch gptme in a project folder.

    gptme
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains gptme?

An independent open-source community around the gptme project (gptme.org), with Erik Bjäreholt as its creator.

Is gptme free?

Yes, MIT-licensed. Model costs depend on your provider — local models via Ollama are free to run.

Does it need a paid API key?

Only for cloud providers; gptme also works with subscription logins (ChatGPT, SuperGrok) or fully local models.

How does it compare to Claude Code or Aider?

gptme is provider-agnostic and terminal-general — not just coding: it adds browsing, vision, computer use, lessons, and cross-harness memory, and can itself run as an MCP/ACP server.

How do I get started?

Run `pipx install gptme`, configure a provider (or local model), and start `gptme` in your project directory.

// keep exploring

Similar tools

Dev Tools

Codewhale

Open-source Rust agent engine and terminal client with provider choice, approvals and receipts

★ 41.1k starsMIT
View guide →
Dev Tools

oh-my-pi

A coding agent with the IDE wired in — LSP, debugger, subagents and code review in your terminal

★ 34.6k starsMIT
View guide →
Dev Tools

kimi-code

Kimi Code CLI — Moonshot's terminal coding agent: single-binary TUI with video input, subagents and MCP.

★ 7.8k starsMIT
View guide →
Dev Tools

pydantic-deepagents

Self-hosted terminal AI assistant and Python agent framework on Pydantic AI.

★ 1.1k starsMIT
View guide →
Dev Tools

codex

OpenAI's lightweight coding agent that runs locally in your terminal

★ 128.2k starsApache-2.0
View guide →
Dev Tools

jcode

A high-performance coding agent harness in Rust - fast TUI, swarms and every provider

★ 20.4k starsMIT
View guide →
// alternatives

Alternatives in Dev Tools

The most-starred other Dev Tools projects in the LibreAI catalogue — the realistic shortlist if gptme is not the right fit.

Get gptme

Free and open — grab the source, star the repo, and start creating.