Skip to main content

Patcherly

Patcherly Python connector

Auto-detect and fix production errors in your Python apps. Agent for any framework that logs to a file or stdout — pairs with your Patcherly account.

For a limited time: 30-day Pro trial — no credit card required. Cancel anytime. Sign up.

PyPI patcherly-connector Documentation Discord — join

Prefer unpinned pip install, or pin from GitHub Releases.


Recommended install (universal installer)

One command downloads the Python agent and launches OAuth pairing:

Platform Command
macOS / Linux / WSL curl -sSL https://api.patcherly.com/install | sudo CONNECTOR_TYPE=python bash
Windows PowerShell $env:CONNECTOR_TYPE = 'python'; irm "https://api.patcherly.com/install.ps1" | iex

The CLI prints a verification URL and a short user code — open the URL, sign in, pick your target, and confirm. Credentials are saved to ~/.patcherly/credentials.json (or /root/.patcherly/ when run as root). Then start the agent — see After install.

Full installer options (paths, SKIP_LOGIN, older versions): Installing a connector.

Package install (PyPI)

pip install patcherly-connector
patcherly login

With the release-tree / universal-installer layout, start the agent:

python patcherly_agent.py

Or from your app (credentials from ~/.patcherly/credentials.json):

from patcherly_agent import PatcherlyAgent

agent = PatcherlyAgent(log_file="logs/error.log")
await agent.start()

Optional on quiet hosts: patcherly heartbeat from a daily cron / systemd timer — see the Python guide.

Pair later (or re-pair)

Install method Command
Universal installer (Linux/macOS) sudo /opt/patcherly-connector/start.sh login
Universal installer (Windows) & "$env:USERPROFILE\patcherly-connector\start.ps1" login
pip patcherly login

On Linux, use sudo when the installer enabled the root-run patcherly-connector systemd unit so credentials land in /root/.patcherly/.

After install

  • Status and approvals: Targets in your Patcherly dashboard.
  • Start and keep the agent running — on Linux with the universal installer: systemctl start patcherly-connector. Otherwise run start.sh / start.ps1, or python patcherly_agent.py. Details: Python connector guide.
  • Path exclusions and patch policies: Path rules for targets.

Test Mode (sample error)

  1. In the dashboard: Targets → your target → Test Mode ON (30-minute window).
  2. On the host:
patcherly send-test

Samples are flagged and do not affect metrics or notifications. See Verify detection with send-test.

Context consent

Default is full. Change with:

patcherly context get
patcherly context set full|minimal|off
patcherly context upload

Env override: PATCHERLY_CONTEXT_CONSENT (overrides {PATCHERLY_CACHE_DIR}/context_consent). off skips uploads; minimal sends runtime/OS/framework only.

Security

OAuth pairing and per-token HMAC signing; fix payloads are verified before apply. Built-in redaction runs before ingest; you can add custom sanitizer patterns per target.

Documentation & support

License

MIT

Using the Patcherly service is governed by our Terms of Service and Acceptable Use policy. Official product support applies only to unmodified connector releases from our official sources.

Download files

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

Source Distribution

patcherly_connector-2.5.19.tar.gz (74.2 kB view details)

Uploaded Source

Built Distribution

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

patcherly_connector-2.5.19-py3-none-any.whl (78.2 kB view details)

Uploaded Python 3

File details

Details for the file patcherly_connector-2.5.19.tar.gz.

File metadata

  • Download URL: patcherly_connector-2.5.19.tar.gz
  • Upload date:
  • Size: 74.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for patcherly_connector-2.5.19.tar.gz
Algorithm Hash digest
SHA256 039b14626cf56f188b680de853d9332146a4a43c663a9a2be7136c0dd3cd28d8
MD5 dbc8477d811ae4d80da30e81cf79d236
BLAKE2b-256 2db08784a16441bfa441fe18e92e766cf9e245d51449dc6ac42dcce68a63b4fa

See more details on using hashes here.

Provenance

The following attestation bundles were made for patcherly_connector-2.5.19.tar.gz:

Publisher: publish-pypi-connector.yml on Patcherly-Official/patcherly-connector-packages

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

File details

Details for the file patcherly_connector-2.5.19-py3-none-any.whl.

File metadata

File hashes

Hashes for patcherly_connector-2.5.19-py3-none-any.whl
Algorithm Hash digest
SHA256 c3373c4c49065c14f8013af748ac10854692d2459f59ca516523243a3e7dd63b
MD5 4a839eccda409693e14d1d35ae604216
BLAKE2b-256 053298afbd356600fc97fb766ccd3dd618b49151a75b38e85e59c018364d8fbd

See more details on using hashes here.

Provenance

The following attestation bundles were made for patcherly_connector-2.5.19-py3-none-any.whl:

Publisher: publish-pypi-connector.yml on Patcherly-Official/patcherly-connector-packages

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

Release history Release notifications | RSS feed

This release

2.5.19 This release

2 files

2.5.15

2 files

2.5.13

2 files

2.5.8

2 files

2.5.1

2 files

2.4.4

2 files

2.4.3

2 files

2.4.2

2 files

2.4.1

2 files

2.3.15

2 files

2.3.12

2 files

2.3.9

2 files

2.3.5

2 files

2.3.3

2 files

2.3.0

2 files

2.2.11

2 files

2.2.10

2 files

2.2.8

2 files

2.2.7

2 files

2.2.6

2 files

2.2.5

2 files

2.2.4

2 files

2.2.3

2 files

2.2.2

2 files

2.2.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page