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.1.tar.gz (73.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.1-py3-none-any.whl (77.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: patcherly_connector-2.5.1.tar.gz
  • Upload date:
  • Size: 73.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.1.tar.gz
Algorithm Hash digest
SHA256 05a92bb24b462ee2cbc6fe0ec2ed4b01fbbe3b218b5bc300dcc2ec095fbdee84
MD5 6b1a26ad63e2727072da3f14a07d34ea
BLAKE2b-256 2d6aa3e69756678c4d3d9503f5540339a9b52b6ad24671f9db072db6bddb689f

See more details on using hashes here.

Provenance

The following attestation bundles were made for patcherly_connector-2.5.1.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.1-py3-none-any.whl.

File metadata

File hashes

Hashes for patcherly_connector-2.5.1-py3-none-any.whl
Algorithm Hash digest
SHA256 ec8a6de98f5ae16e65332022c4d77545c13ea5398df5000dc8c3829570364e8c
MD5 776668b9039ee5e8414981fbdf7e0597
BLAKE2b-256 e290eccf084bffc6694c2ad2cec93f788e39e2284e40030d8f805c6d4def2f51

See more details on using hashes here.

Provenance

The following attestation bundles were made for patcherly_connector-2.5.1-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

2.5.19

2 files

2.5.15

2 files

2.5.13

2 files

2.5.8

2 files

This release

2.5.1 This release

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