Metadata-Version: 2.4
Name: silinosic-x
Version: 11.2.2
Summary: Multi-engine OSINT orchestration for profile intelligence, domain-surface reconnaissance, and fused correlation reporting.
Author-email: Niyor Kalita <voltsparx@gmail.com>
License-Expression: LicenseRef-Proprietary
Project-URL: Homepage, https://github.com/voltsparx/Silinosic-X
Project-URL: Repository, https://github.com/voltsparx/Silinosic-X
Project-URL: Issues, https://github.com/voltsparx/Silinosic-X/issues
Keywords: osint-framework,intelligence,recon,correlation,security
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Information Technology
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE.md
Requires-Dist: aiohttp
Requires-Dist: cryptography>=42.0.0
Requires-Dist: dnspython>=2.4.0
Requires-Dist: matplotlib>=3.8.0
Requires-Dist: numpy>=1.24.0
Requires-Dist: Pillow>=10.0.0
Requires-Dist: python-docx>=1.1.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: pytesseract>=0.3.10
Requires-Dist: reportlab>=4.2.0
Requires-Dist: scapy>=2.5.0
Requires-Dist: rich
Provides-Extra: full
Requires-Dist: easyocr>=1.7.1; extra == "full"
Requires-Dist: scapy>=2.5.0; extra == "full"
Provides-Extra: ocr
Requires-Dist: easyocr>=1.7.1; extra == "ocr"
Requires-Dist: opencv-python-headless>=4.8.0; extra == "ocr"
Provides-Extra: reports
Requires-Dist: matplotlib>=3.8.0; extra == "reports"
Requires-Dist: python-docx>=1.1.0; extra == "reports"
Requires-Dist: reportlab>=4.2.0; extra == "reports"
Provides-Extra: dev
Requires-Dist: pytest<9.0,>=8.0; extra == "dev"
Requires-Dist: ruff<1.0,>=0.8; extra == "dev"
Requires-Dist: mypy<2.0,>=1.11; extra == "dev"
Requires-Dist: build<2.0,>=1.2; extra == "dev"
Requires-Dist: twine<7.0,>=6.0; extra == "dev"
Dynamic: license-file

# Silinosic-X v11.2.2

> Theme: Ember  
> OSINT orchestration, media intelligence, and Reporter-grade artifacts for profile, surface, fusion, and OCR-led investigations.

<p align="center">
  <img src="https://raw.githubusercontent.com/voltsparx/Silinosic-X/refs/heads/main/docs/images/illustration/silinosic-x-icon.png" alt="Silinosic-X logo" width="420">
</p>

<p align="center">
  <img src="https://img.shields.io/badge/version-v11.2.2-F47C20?style=for-the-badge" alt="Version v11.2.2">
  <img src="https://img.shields.io/badge/theme-Ember-E86F1C?style=for-the-badge" alt="Theme Ember">
  <img src="https://img.shields.io/badge/python-3.11%20%7C%203.12%20%7C%203.13-3776AB?style=for-the-badge&logo=python&logoColor=white" alt="Python Versions">
</p>

<p align="center">
  <img src="https://img.shields.io/badge/package-silinosic--x-CB6D1E?style=for-the-badge" alt="PyPI package name">
  <img src="https://img.shields.io/badge/import-silinosic__x-784421?style=for-the-badge" alt="Python import name">
  <img src="https://img.shields.io/badge/license-Proprietary-8B0000?style=for-the-badge" alt="License Proprietary">
</p>

Silinosic-X is a Python intelligence framework for authorized OSINT work. It combines profile reconnaissance, domain-surface analysis, fusion scoring, public-media reconnaissance, and OCR image scanning into one runtime with plugins, filters, engine policies, and categorized artifacts.

## What v11.2.2 includes

- Reporter is now the primary reporting layer for HTML and CLI summaries.
- Media reconnaissance and OCR image scanning are first-class lanes instead of side notes.
- HTML artifacts are organized as case views with graphs, categorized sections, extension drill-downs, vulnerability context, and a closing `Reporter Brief`.
- The docs tree and website are aligned to the current runtime instead of old release-planning notes.

## Recent runtime additions

- Platform intelligence now loads from an expanded manifest with `91` validated platforms, including major high-value public OSINT surfaces.
- Profile scanning can emit live pipeline events as platforms resolve, allowing downstream enrichment to start before the full scan ends.
- Live enrichment now hunts contact and credential signals from `FOUND` profile rows during the scan itself.
- A persistent SQLite knowledge base tracks targets, found profiles, contact signals, fingerprints, and risk indicators across runs.
- `silinosic-x doctor` now reports engine health, knowledge-base status, and Docker runtime status.
- Docker is now a first-class execution path through `--docker`, with runtime detection, image build support, and mounted output persistence.
- Tor runtime management now has a higher-level setup layer that can deploy `torrc`, check readiness, and coordinate startup.

## Core workflows

- `profile` scans usernames and public profiles across platform manifests.
- `surface` analyzes domain exposure, transport posture, and surface intelligence.
- `fusion` correlates profile and surface evidence into scored intelligence.
- `orchestrate` runs the policy-led orchestration pipeline directly.
- `ocr` runs dedicated OCR image scanning across local paths and remote URLs.
- media plugins add public image/video/post-text reconnaissance and stego-style triage.

## Install, run, import

```bash
pip install silinosic-x
silinosic-x
silinosic-x doctor
```

```python
import silinosic_x

print(silinosic_x.__version__)
```
> Note: the Python-PIP package is not available right now cause changing repo name...

From source:

```bash
git clone https://github.com/voltsparx/Silinosic-X.git
cd Silinosic-X
pip install -e .
silinosic-x --help
```

Optional extras:

```bash
pip install ".[reports]"
pip install ".[ocr]"
```

`pytesseract` is a Python wrapper, but OCR still depends on a reachable `tesseract` binary. Silinosic-X now reports which OCR/image backends were actually available during the run, and `silinosic-x doctor` gives a quick local diagnostic pass for OCR, Tor, Reporter backends, output settings, and runtime inventory.

Docker runtime:

```bash
silinosic-x --docker
silinosic-x prompt --docker
silinosic-x profile alice --docker
silinosic-x surface example.com --docker
silinosic-x prompt --docker --tor
```

On first use, Silinosic-X can check Docker, install it when supported and approved, build the image, and then launch the requested command inside the container.

## Quick examples

```bash
silinosic-x profile alice --html
silinosic-x surface example.com --html
silinosic-x fusion alice example.com --html
silinosic-x ocr ./captures/poster.png --url https://example.com/image.png --html
silinosic-x profile alice --plugin media_recon_engine --plugin post_signal_intel --plugin stego_signal_probe --html
silinosic-x prompt
silinosic-x prompt --docker
silinosic-x doctor
```

## Reporter outputs

Silinosic-X writes artifacts under `output/` and can emit:

- CLI summaries
- JSON payloads
- CSV exports plus companion CSV slices
- HTML Reporter case views
- SQLite case stores
- DOCX case documents
- PDF case documents
- run logs and framework logs

Reporter is designed to make the result easier to triage by grouping identity findings, reliability issues, correlation, vulnerabilities, plugin/filter signals, OCR/media lanes, and the final `Reporter Brief`.

Recent report/runtime improvements also include:

- live enrichment sections in HTML output when profile pipeline signals are captured
- relationship and graph-backed sections for fusion-style analysis
- persistent knowledge-base storage at `output/silinosic_x_kb.db`
- richer `doctor` visibility for OCR, Tor, Docker, engines, and output/runtime state

In prompt mode, attachables can be configured as session defaults with commands like:

```text
enable plugin threat_conductor
enable filter contact_canonicalizer
enable module source-pack-01-module-1
config
```

## Documentation

- [Docs Index](docs/README.md)
- [Operator Guide](docs/operator-guide.md)
- [Architecture](docs/architecture.md)
- [Extensions](docs/extensions.md)
- [Media Intelligence](docs/media-intelligence.md)
- [Reporter](docs/reporter.md)
- [Development](docs/development.md)
- [Docker Guide](docs/docker.md)
- [Website](docs/website/README.md)

## Website and Pages

Primary Pages URL:

- `https://voltsparx.github.io/Silinosic-X/`

If that direct URL shows GitHub's "site not found" page, the usual cause is not the website files themselves. It usually means GitHub Pages is not currently serving the project site yet. For this repository, Pages must be enabled with `GitHub Actions` as the source, and the `Silinosic-X Pages` workflow must complete successfully on `main` or `master`.

## Safety

- Legal and authorized use only
- Respect platform terms, privacy, and local law
- Do not use Silinosic-X for stalking, harassment, or unauthorized surveillance

## Developer notes

Useful local checks:

```bash
python -m pytest -q
python -m ruff check .
python -m mypy
python -m compileall -q core filters modules plugins tests silinosic-x.py
python scripts/smoke_suite.py
silinosic-x doctor
silinosic-x --help
```

Core package naming:

- package install name: `silinosic-x`
- CLI entrypoint: `silinosic-x`
- Python import path: `silinosic_x`

## Author

- Author: voltsparx
- Contact: voltsparx@gmail.com
- Repository: https://github.com/voltsparx/Silinosic-X
