Metadata-Version: 2.5
Name: sosya
Version: 0.0.1
Summary: Describe a hacking lab in plain English. Get it running, isolated and verified.
License-Expression: MIT
License-File: LICENSE
Keywords: ctf,cyber-range,docker,lab,llm,security,training,vulhub
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Security
Requires-Python: >=3.12
Requires-Dist: pydantic>=2.14
Requires-Dist: pyyaml>=6.0.3
Requires-Dist: rich>=15.0
Requires-Dist: typer>=0.29
Description-Content-Type: text/markdown

# 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](https://github.com/vulhub/vulhub)), checks that it
actually works, and keeps it isolated from your network by default.

```console
$ 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](https://docs.astral.sh/uv/) installed:

```console
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](https://github.com/vulhub/vulhub), MIT license.

## License

[MIT](LICENSE)
