gptme-acp

ACP (Agent Client Protocol) entry point for gptme.

This is a thin shim package that allows gptme to be listed in the ACP agent registry and launched via uvx, enabling agent discovery in editors like Zed and JetBrains.

Usage

Quick start (no install required)

uvx gptme-acp

Persistent install

pipx install gptme-acp
gptme-acp

What this package does

gptme-acp is a minimal wrapper that:

Declares gptme[acp] as its dependency (pulls in gptme + the agent-client-protocol library)
Exposes gptme-acp as its default executable — the ACP server that editors connect to

The agent communicates with editors via JSON-RPC over stdio using the ACP protocol.

ACP Agent Registry

This package exists so gptme can be listed in the ACP agent registry:

{
  "package": "gptme-acp",
  "launch": {"type": "uvx"}
}

The registry powers agent discovery in Zed, JetBrains, and other ACP-compatible editors. Without this package, the registry cannot launch gptme because:

uvx gptme runs the interactive CLI, not the ACP server
uvx --from 'gptme[acp]' gptme-acp requires --from, a shape the registry cannot express
Extras-qualified specs like gptme[acp] fail the registry's package-existence check

Configuration

The ACP agent uses gptme's standard configuration (~/.config/gptme/config.toml). API keys are read from environment variables (ANTHROPIC_API_KEY, OPENAI_API_KEY, etc.).

Documentation

Full ACP documentation: https://gptme.org/docs/acp.html

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gptme_acp-0.33.1.dev20260820.tar.gz (2.3 kB view details)

Uploaded Aug 20, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

gptme_acp-0.33.1.dev20260820-py3-none-any.whl (2.3 kB view details)

Uploaded Aug 20, 2026 Python 3

File details

Details for the file gptme_acp-0.33.1.dev20260820.tar.gz.

File metadata

Download URL: gptme_acp-0.33.1.dev20260820.tar.gz
Upload date: Aug 20, 2026
Size: 2.3 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for gptme_acp-0.33.1.dev20260820.tar.gz
Algorithm	Hash digest
SHA256	`1b69c2ac113a8a3be1aa1e59c14972d80fa4a1c48d8f02e8088d0ef23d8beb7d`
MD5	`72d4380a530984dc6312148a2f272a31`
BLAKE2b-256	`9a42b2209fb6a494f0d5906757ef10b0e0791a87542dfdff43d28368e2b4e4d6`

See more details on using hashes here.

Provenance

The following attestation bundles were made for gptme_acp-0.33.1.dev20260820.tar.gz:

Publisher: release.yml on gptme/gptme

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: gptme_acp-0.33.1.dev20260820.tar.gz
- Subject digest: 1b69c2ac113a8a3be1aa1e59c14972d80fa4a1c48d8f02e8088d0ef23d8beb7d
- Sigstore transparency entry: 2532091191
- Sigstore integration time: Aug 20, 2026
Source repository:
- Permalink: gptme/gptme@7092325b227f67af69665c342c884517026933cf
- Branch / Tag: refs/heads/master
- Owner: https://github.com/gptme
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@7092325b227f67af69665c342c884517026933cf
- Trigger Event: schedule