Skip to main content

Sosya

Describe a hacking lab in plain English. Get it running, isolated and verified.

Status: pre-release. Sosya v0.1 ships on November 24, 2026.

Sosya turns one sentence into a working, multi-container security lab. It builds it from real, documented vulnerable environments (Vulhub), checks that it actually works, and keeps it isolated from your network by default.

$ sosya new "Struts2 app in a DMZ, passwordless Redis reachable only from the web server"
$ sosya shell dmz-redis    # Kali, inside the range network

Why Sosya

  • Verified. A range is "ready" only after it boots and every service answers from the attacker box.
  • Safe by default. No ports published on your host: targets live on internal networks.
  • Lightweight. Docker on a laptop. No hypervisor, no dedicated server.
  • Any LLM. Anthropic, OpenAI or any OpenAI-compatible endpoint, including local models via Ollama.

Try what exists today

From a checkout of this repository, with uv installed:

uv run sosya doctor

Responsible use

Sosya builds local labs for training and research on systems you own. It does not generate or run exploits.

Credits

Vulnerable environments by Vulhub, MIT license.

License

MIT

Metadata

Release files for sosya 0.0.1

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

Source distribution (sdist)

Source distribution for sosya 0.0.1
File Size Uploaded Provenance Actions
sosya-0.0.1.tar.gz 27.0 kB With provenance Details for sosya-0.0.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for sosya 0.0.1
File Interpreter ABI Platform Actions
sosya-0.0.1-py3-none-any.whl Python 3 none any Details for sosya-0.0.1-py3-none-any.whl

Total release size: 33.3 kB

Release files / sosya-0.0.1.tar.gz

Download URL sosya-0.0.1.tar.gz
Size 27.0 kB
Tags Source
SHA-256 checksum
How to use checksums
9edc13b4d03162b97f87bc9e7e3daa45bce529943b4b1aef7e81d3b9ae2336c2
BLAKE2b-256 checksum
How to use checksums
44b7d57577c4df21ee3c637e5143d78c4efb9571e83b6cb61dc51e62d42dd77e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","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 Nov 20, 2026.

Transparency log

Release files / sosya-0.0.1-py3-none-any.whl

Download URL sosya-0.0.1-py3-none-any.whl
Size 6.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a36c762ae56c444dacb216107d28d6473d1ec7e464bb3a57d21f0f95e42b33bb
BLAKE2b-256 checksum
How to use checksums
b2f9908da7991cfa100357de74a16189a42f125fdab2678774dec6a44cb4bd2a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","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 Nov 20, 2026.

Transparency log

Security for sosya 0.0.1

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for sosya-0.0.1.tar.gz

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 Nov 20, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.0.1 This release

2 release files Full provenance

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