sharkit
OSINT / HUMINT / GEOINT research framework — a modular CLI for gathering and correlating open-source intelligence from the terminal.
Built for Linux. Runs anywhere Python 3.11+ runs — including Termux on Android.
Requirements
- Python >= 3.11
piporuv
Installation
From PyPI:
pip install sharkit
Or with uv:
uv tool install sharkit
Then launch the interactive shell:
sharkit
Termux / Android
sharkit is pure Python (no compiled extensions) and depends only on prompt_toolkit
and httpx, so it installs and runs on Termux without any native build step.
pkg update && pkg install python
pip install sharkit
sharkit
If Termux's Python is marked externally managed, install into a virtual environment:
pkg install python
python -m venv ~/sharkit-venv
~/sharkit-venv/bin/pip install sharkit
~/sharkit-venv/bin/sharkit
- Configuration, history and cache live under
~/.config/sharkit(on Android:/data/data/com.termux/files/home/.config/sharkit). - Network access uses the standard Termux permission — no extra setup required.
- The UI relies on ANSI escape codes and Unicode box-drawing, which Termux's terminal renders natively.
Quick start
sharkit # start the interactive shell
help # list commands
use testing/demo/echo # load a module
set message "hello" # configure an option
run # execute the active module
history # show command history
clear # clear the screen
exit # quit
Available commands: help, banner, version, status, use, back, info,
show, set, unset, run, search, history, clear, exit.
Modules
Modules are discovered automatically from the packaged sharkit/modules directory:
testing/demo/echo— echo module for testing the frameworktesting/http/metadata— HTTP metadata gathering (status, headers, content type, …)
Development
git clone https://github.com/sshsrv/sharkit
cd sharkit
uv sync --all-groups
uv run sharkit
Quality gates: uv run ruff check ., uv run mypy src/, uv run pytest -q.
Disclaimer
sharkit is a research tool. Use it responsibly and in accordance with applicable law and the terms of service of any system you interact with.
1 maintainer
Release files for sharkit 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| sharkit-0.1.1.tar.gz | 16.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sharkit-0.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 42.4 kB
Release files / sharkit-0.1.1.tar.gz
| Download URL | sharkit-0.1.1.tar.gz |
|---|---|
| Size | 16.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
059a4ebd3d40ba0b5775f978ca4d82b84e16e5252a11a3e06cd7c257002832eb
|
|
BLAKE2b-256 checksum How to use checksums |
be28c1c816fa4ea58dd836bb131da58ff2b30952c7624b3f6d226a9fd10ad8ba
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 29, 2026.
Transparency logRelease files / sharkit-0.1.1-py3-none-any.whl
| Download URL | sharkit-0.1.1-py3-none-any.whl |
|---|---|
| Size | 25.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f98e3b68d2985cbb89de5563158cabc6c685861d7b7e198bdea4b3da4fac770d
|
|
BLAKE2b-256 checksum How to use checksums |
02c582d2ed33e8e363ee325b3b7285d955b9a9ec6769bc63d6989e3cbbcce982
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 29, 2026.
Transparency log
