spry · PyPI

SPRY SPY PRY SPRY SPY PRY SPRY

social media intelligence from the terminal

Version 0.5.7 - Major Update:

Upgraded to Python 3.12+ (supports 3.12, 3.13, 3.14)
Migrated to uv - Fast Python package manager (10-100x faster than pip)
Modernized codebase - Removed Python 2 compatibility, modern Python 3 syntax
Enhanced Instagram detection - Improved profile image extraction and error handling
Better PDF reports - Now includes full list of found accounts with clickable links
SSL error handling - Gracefully handles sites with certificate issues
Wayback Machine support - Checks archived versions of dead sites (Myspace, Delicious, etc.)
Updated URLs - Twitter now uses x.com

Requires Python 3.12 or higher.

WORKING SCREENSHOT (version 0.5.7)

30+ social accounts checked, including archived sites via Wayback Machine

Profile Image Extraction - Automatically downloads Instagram profile pictures when found
Comprehensive PDF Reports - Generates detailed PDF reports with all found accounts and clickable links
30+ Social Networks - Checks major platforms plus archived sites via Wayback Machine
Smart Detection - Properly handles non-existent profiles and error pages
Progress Indicators - Visual progress dots and color-coded output
Rate Limiting - Randomized pausing between lookups to avoid getting blocked
User Agent Rotation - Uses +8500 different User Agent strings (can override via -u arg)
Proxy Support - Tor and HTTP proxy support via -p arg
SSL Error Handling - Automatically handles sites with certificate issues
Modern Python - Built for Python 3.12+ with modern syntax and best practices

Using uv (recommended - fastest):

First install uv:

curl -LsSf https://astral.sh/uv/install.sh | sh

Then install spry:

uv pip install spry

Using pip:

pip install spry

From source:

git clone git@github.com:james-see/spry.git
cd spry
uv sync
uv run spry [username]

or:

uv run python spry-run.py [username]

DEV PATH?

the goal is to get to +100 services that have public url user name profile links to check and gather information from

Basic usage:

spry jamesacampbell

Generate PDF report with all found accounts:

spry jamesacampbell --report

Verbose mode (show user agent for each request):

spry jamesacampbell -v

Use with Tor proxy:

spry jamesacampbell -p 127.0.0.1:9050

Set custom wait time between requests (1-10 seconds):

spry jamesacampbell -w 10

Override user agent:

spry jamesacampbell -u "My Custom User Agent"

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution for spry 0.5.7
File	Size	Uploaded
spry-0.5.7.tar.gz	142.0 kB	Nov 16, 2025	Details

Table of built distributions (wheels) for spry 0.5.7
File	Interpreter	ABI	Platform	Reset
spry-0.5.7-py3-none-any.whl 144.2 kB Nov 16, 2025	Python 3	none	any	Details

Total release size: 286.1 kB

Download URL	spry-0.5.7.tar.gz
Size	142.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`4173ec40282812debb9e62cd6434892dc516f3db147a5d8214eb375a0016649c`
BLAKE2b-256 checksum How to use checksums	`e443e1d7eace34726507a1ef86cf5c92370e247ff6be1def7d06aa1a39dc5a7d`
Upload date	Nov 16, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.6.5`

Download URL	spry-0.5.7-py3-none-any.whl
Size	144.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`1827d36969a2df9db7d304ae0fa81514f90b1e3a0b70ed60805b71123a57827d`
BLAKE2b-256 checksum How to use checksums	`54a4bd859976639a2a42d36526e75c7d8088886ec08a27b5006966e34315f17a`
Upload date	Nov 16, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.6.5`