packages

gptme-contrib Packages

Python packages for gptme agents.

Packages

Package	Purpose	Install
gptme-forum	Git-native agent forum (agentboard) — posts, @mentions, direct messages	uv pip install -e packages/gptme-forum
gptme-subscription	Subscription observation, pressure scoring, and capacity-aware routing	uv pip install -e packages/gptme-subscription
gptme-daily-briefing	Daily briefing generation for agents	uv pip install -e packages/gptme-daily-briefing
gptme-dashboard	Agent usage dashboards and metrics	uv pip install -e packages/gptme-dashboard
gptmail	Email/message handling	uv pip install -e packages/gptmail
gptodo	Task management and work queues	uv pip install -e packages/gptodo
gptme-activity-summary	Activity summarization (journals, GitHub, sessions, tweets, email)	uv pip install -e packages/gptme-activity-summary
gptme-sessions	Session tracking, analytics, and trajectory extraction	uv pip install -e packages/gptme-sessions
gptme-voice	Voice interface using OpenAI Realtime API	uv pip install -e packages/gptme-voice
gptme-whatsapp	WhatsApp integration for agents	uv pip install -e packages/gptme-whatsapp
gptme_lessons_extras	Lesson format validation and analysis	uv pip install -e packages/gptme-lessons-extras
gptme_contrib_lib	Shared utilities across packages	uv pip install -e packages/gptme-contrib-lib
gptme_runloops	Autonomous run loop infrastructure	uv pip install -e packages/gptme-runloops
gptme-cc-memory	Typed, git-tracked, hook-injected session memory for Claude Code	uv pip install -e packages/gptme-cc-memory

Backward Compatibility

Source-level symlinks are provided for backward compatibility with existing imports:

• from lessons import ... works via gptme-lessons-extras/src/lessons symlink
• from lib import ... works via gptme-contrib-lib/src/lib symlink
• from run_loops import ... works via gptme-runloops/src/run_loops symlink

Structure

packages/package-name/
├── pyproject.toml    # Config
├── src/package_name/ # Source (new name)
├── src/old_name/     # Symlink to package_name (backward compat)
└── tests/            # Tests

Development

# Install workspace
uv sync --all-packages

# Run package tests
uv run pytest packages/gptodo/tests

# Run all tests
make test

# Type check
make typecheck

Adding Dependencies

Edit packages/NAME/pyproject.toml, then:

uv sync

References

• uv workspaces
• Root pyproject.toml - workspace configuration