AgentGraph Feed

The AgentGraph Feed package provides both the AgentGraph connector and the shared HTTP server used to exchange graph mutation events.

Installation

Install the connector into the same Python environment as AgentGraph:

uv pip install agentgraph-connector-feed

The 0.1.x and 0.2.x connector releases support agentgraph-server>=0.6.1,<0.7. The 0.3.x releases require agentgraph-server>=0.7.0,<0.8.

Configuration

Configure the feed server base URL, then inspect the saved configuration:

agentgraph connector feed configure http://localhost:8767
agentgraph connector feed status

The configured URL must not include /events or /events-feed. The connector adds /events and /events/tail when it publishes and polls respectively. For a deployed server behind a reverse proxy, configure the URL at which those endpoints are exposed.

The connector publishes new local observations, bookmark changes, and explicit deletions as best-effort HTTP requests. It polls the feed once per minute. Its first poll starts at the current feed tail, so existing events are not imported.

Entity upserts are ignored by default. Pass --publish-upserts to publish full committed entity and edge snapshots.

Server

Run the feed server locally with:

uv run agentgraph-feed-server

The server listens on port 8767 by default. Set AGENTGRAPH_FEED_SERVER_PORT to use another port. The event database defaults to <AGENTGRAPH_CONFIG_DIR>/agentgraph-feed-events.db, where the config directory defaults to ~/.agentgraph. Set AGENTGRAPH_FEED_DB to override the complete database path.

The server exposes GET /healthcheck, POST /events, GET /events, GET /events/tail, and DELETE /events?through=<sequence>. The delete endpoint purges only events at or before the supplied sequence, preserving events appended while a consumer processes its current page. It is intended for clients using the server as a one-producer, one-consumer queue.

Security

The feed is unauthenticated and should only be exposed on a trusted network.

Development

uv sync --locked
uv run pytest
uv run pyright
uv run ruff check .
uv run ruff format --check .

Download files

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

Source Distribution

agentgraph_connector_feed-0.3.0.tar.gz (13.3 kB view details)

Uploaded Sep 9, 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.

agentgraph_connector_feed-0.3.0-py3-none-any.whl (10.3 kB view details)

Uploaded Sep 9, 2026 Python 3

File details

Details for the file agentgraph_connector_feed-0.3.0.tar.gz.

File metadata

Download URL: agentgraph_connector_feed-0.3.0.tar.gz
Upload date: Sep 9, 2026
Size: 13.3 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for agentgraph_connector_feed-0.3.0.tar.gz
Algorithm	Hash digest
SHA256	`75d8b4ee0bca55433219b36aec0717b9019c09a452e99725dc27309401e1ccb7`
MD5	`56f75a04ff3da4b9658f364ad60faebf`
BLAKE2b-256	`f63c6f97650d412a10778f9bdf35112fd1a84b0cc8f1f18ae381227257cda0a6`

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentgraph_connector_feed-0.3.0.tar.gz:

Publisher: pypi-release.yml on simonexmachina/agentgraph-connector-feed

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: agentgraph_connector_feed-0.3.0.tar.gz
- Subject digest: 75d8b4ee0bca55433219b36aec0717b9019c09a452e99725dc27309401e1ccb7
- Sigstore transparency entry: 2774527246
- Sigstore integration time: Sep 9, 2026
Source repository:
- Permalink: simonexmachina/agentgraph-connector-feed@34c19d1f51ce3012cb560bcd7c803f0cd2f34e50
- Branch / Tag: refs/tags/v0.3.0
- Owner: https://github.com/simonexmachina
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: pypi-release.yml@34c19d1f51ce3012cb560bcd7c803f0cd2f34e50
- Trigger Event: push