Skip to main content

TryClear — Semantic image threat evaluation from the command line

Project description

TryClear CLI

A picture is worth a thousand words. Attackers know that. Your security tools don't.

TryClear evaluates images for semantic threats — phishing, brand impersonation, QR code attacks, hidden page techniques, and visual prompt injection.

Setup

# 1. Install
pip install tryclear

# 2. Authenticate (grab your API key from tryclear.io/settings)
tryclear auth

# 3. Evaluate
tryclear eval suspicious-screenshot.png

That's it. Forensic verdict in your terminal.

Commands

Command Description
tryclear auth Store your API key
tryclear eval <file> Evaluate an image, get a forensic verdict
tryclear eval --json <file> Structured JSON output for scripting
tryclear status <id> Check evaluation status
tryclear report <id> Fetch full forensic report

Supported Formats

PNG, JPG, JPEG, BMP, TIFF, SVG, WebP, HEIC/HEIF

Example

$ tryclear eval bank-document.tiff

  ◆ TryClear v2.0.0

  bank-document.tiff · 269 KB · image/tiff

  ╭──────────────────────────────────────────────────╮
  │   MALICIOUS · High Risk                          │
  ╰──────────────────────────────────────────────────╯

  Page 1 appeared clean, but hidden content on Page 2
  revealed the threat. This 'Hidden Page' technique is
  used to evade security scanners. The attack
  impersonates Bank of America.

    ⚠ Bank of America impersonation detected
    ⚠ QR code → hxxps://mail[.]google[.]com/mail/u/0/
    ⚠ Threat concealed on Page 2 of 2

  Full report → https://tryclear.io/report/ana_demo

CI/CD Integration

tryclear eval ./assets/ --fail-on malicious --exit-code 1
Exit Code Meaning
0 CLEAR
1 SUSPICIOUS
2 MALICIOUS
3 Error

Auth

The CLI resolves your API key in this order:

  1. TRYCLEAR_API_KEY environment variable
  2. ~/.config/tryclear/config.json
  3. ~/.config/clear/config.json

Learn More

tryclear.io

Project details


Download files

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

Source Distribution

tryclear-2.0.0.tar.gz (30.5 kB view details)

Uploaded Source

Built Distribution

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

tryclear-2.0.0-py3-none-any.whl (23.9 kB view details)

Uploaded Python 3

File details

Details for the file tryclear-2.0.0.tar.gz.

File metadata

  • Download URL: tryclear-2.0.0.tar.gz
  • Upload date:
  • Size: 30.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.6

File hashes

Hashes for tryclear-2.0.0.tar.gz
Algorithm Hash digest
SHA256 121ab515fe384e506fdf04643a57eb4db4a17c54988facef61b5479500face24
MD5 ed271266116540981d7b9b97354023c8
BLAKE2b-256 104be28a629c1ede7d29224a3128b1b11da52a83ee2e16a2d523c6ba25e458d8

See more details on using hashes here.

File details

Details for the file tryclear-2.0.0-py3-none-any.whl.

File metadata

  • Download URL: tryclear-2.0.0-py3-none-any.whl
  • Upload date:
  • Size: 23.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.6

File hashes

Hashes for tryclear-2.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 19201a501877cc760254fd8abb7a791e44ae645cab0279e0e6cd195b757c1c2c
MD5 ad0fe10dac7eb544e83bb877c26be8f4
BLAKE2b-256 971f196f1fa391b6f992dadc3b62940aec04f37fd92b05a85a02203cafb63e8d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page