# Install gptme with Homebrew AI assistant in your terminal. Version 0.31.0 via Homebrew; verified 2026-06-21. ## Install ```sh sudo av install brew:gptme ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install gptme ``` Evidence: local Homebrew formula metadata ## Package facts - **Package key:** brew:gptme - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.31.0 - **Source summary:** AI assistant in your terminal - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Last updated:** 2026-06-21T10:55:07Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - gptme (cli) - gptme-dspy (cli) - gptme-eval (cli) - gptme-nc (cli) - gptme-server (cli) - gptme-util (cli) - gptme-wut (cli) - gptme (alias) - gptme-dspy (alias) - gptme-eval (alias) - gptme-nc (alias) - gptme-server (alias) - gptme-util (alias) - gptme-wut (alias) ## Dependencies - certifi - cryptography - libyaml - pillow - pydantic - python@3.14 - rpds-py ## Build dependencies - rust ## Uses from macOS - libxml2 - libxslt ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 0.31.0 - Package-manager updated: 2026-06-21 - Local data: ok - Upstream repository: https://gptme.org/docs/ - info: Release/tag comparison is only available for GitHub repositories. ## Project history and usage gptme is a terminal AI assistant and agent framework that gives language models access to local tools such as shell commands, file editing, browser/web operations, and project context. ### Project history The official repository describes gptme as an agent in the terminal, equipped with local tools to write code, use the terminal, and browse the web. The project site positions it as a small, simple assistant rather than a platform trying to cover every workflow. The documentation and release pages show a project organized around CLI usage, tools, prompts, configuration files, local logs, project workspaces, plugins, RAG/context features, and autonomous agent patterns. The release documentation records a long sequence of tagged versions. By v0.8.1, release notes already included auto-continue/recovery after tool execution, project-context work, web UI conversation creation, command-output capture, and integration-test improvements. ### Adoption history gptme belongs to the package-manager wave of LLM developer tools that moved from simple chat wrappers toward local agent workflows. Its Homebrew package exposes several executables, reflecting a broader tool suite rather than a single chat binary. The project's adoption signal is strongest among developers who want a terminal-native assistant with reproducible logs, configurable model/provider settings, and explicit local tool use. ### How it is used Users run `gptme` as an interactive terminal assistant and configure user preferences in `~/.config/gptme/config.toml`. Secrets and local overrides can live in `~/.config/gptme/config.local.toml`, and project-specific behavior can be configured with `gptme.toml` in a workspace root. The docs cover CLI subcommands, prompt/context handling, tool execution, project config, MCP server configuration, plugin settings, chat logs, and agent-oriented workflows. The package also installs helper commands such as `gptme-server`, `gptme-util`, and evaluation or integration utilities, making it more of a local developer-assistant toolkit than a plain chat command. ### Why package nerds care gptme is significant for package nerds because it packages an AI agent as a normal terminal tool with config files, subcommands, logs, plugins, and optional integrations instead of hiding everything behind a hosted UI. Its config split between committed preferences and local secret overrides is also packaging-relevant: it gives dotfile users a predictable Unix-style setup while leaving room for provider keys and MCP credentials. ### Timeline - 2020s: gptme develops as a terminal AI assistant and local agent toolkit. - 2024: Public project discussion includes config.toml documentation needs. - 2026: Official documentation lists release pages back through early v0.x versions. - 2026: Release notes for v0.8.1 document agent/tooling features such as auto-continue after code execution and project-context work. ### Related projects - OpenAI, Anthropic, llama.cpp, OpenRouter, MCP servers, RAG tools, and local shell/file/browser tooling are all part of gptme's documented integration space. - gptme-contrib provides related scripts, plugins, lessons, and integration examples around the core project. ### Sources - - - - - - - ## Security Notes No matching local secret-handling manifest was found for gptme. Nucleus package metadata is still published here so future coverage has a stable package URL. ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: ~/.config/gptme/config.toml, ./gptme.toml ## Credential files - Unix: ~/.config/gptme/config.local.toml, ~/.config/gptme/config.toml ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** gptme - **Version Scheme:** 0 - **Revision:** 13 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Related links - [MCP tool packages](https://www.automicvault.com/pkg/mcp-tools/) - Mentions MCP or Model Context Protocol. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew. - [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew. - [mods](https://www.automicvault.com/pkg/brew/mods/) - Shares av.db curated category or tags: ai, cli, developer-tools, llm, terminal. - [chatblade](https://www.automicvault.com/pkg/brew/chatblade/) - Shares av.db curated category or tags: ai, cli, developer-tools, terminal. - [context7-mcp](https://www.automicvault.com/pkg/brew/context7-mcp/) - Shares av.db curated category or tags: ai, cli, developer-tools, llm. - [docker-agent](https://www.automicvault.com/pkg/brew/docker-agent/) - Shares av.db curated category or tags: agents, ai, cli, developer-tools. - [fabric-ai](https://www.automicvault.com/pkg/brew/fabric-ai/) - Shares av.db curated category or tags: ai, cli, developer-tools, llm. - [gollama](https://www.automicvault.com/pkg/brew/gollama/) - Shares av.db curated category or tags: ai, cli, developer-tools, llm. - [gptscript](https://www.automicvault.com/pkg/brew/gptscript/) - Shares av.db curated category or tags: ai, cli, developer-tools, llm. - [localai](https://www.automicvault.com/pkg/brew/localai/) - Shares av.db curated category or tags: ai, cli, developer-tools, llm. - [kimi-cli](https://www.automicvault.com/pkg/brew/kimi-cli/) - Both packages touch the same language runtime or ecosystem. Shared terms: agent, ai, certifi, cli, cryptography. - [oterm](https://www.automicvault.com/pkg/brew/oterm/) - Both packages touch the same language runtime or ecosystem. Shared terms: ai, certifi, cli, cryptography, developer. - [rawdog](https://www.automicvault.com/pkg/brew/rawdog/) - Both packages touch the same language runtime or ecosystem. Shared terms: agent, ai, certifi, cli, developer. ## Combined YAML source View the package source record on GitHub. [combined/gptme.yml](https://github.com/automic-vault/db/blob/main/combined/gptme.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - cross-ecosystem install command graph