anti 214ce50941 release: bump all packages to 0.1.1, add PyPI metadata and CHANGELOG
- Add readme field to all three pyproject.toml files (populates PyPI description page)
- Bump versions to 0.1.1 and update behave-core pin in shell/text
- Update Install sections in root, BEHAVE-SHELL, and BEHAVE-TEXT READMEs to lead with pip install from PyPI
- Add CHANGELOG.md at project root (Keep-a-Changelog format)
2026-05-17 20:30:38 -04:00

BEHAVE

Behavioral observation spec for adversarial network attribution. BEHAVE defines a structured observation envelope (core) and two domain registries — shell-session (BEHAVE-SHELL) and text/messaging (BEHAVE-TEXT) — used to build behavioral signatures over collected operator activity.

Packages

Package Description Path
behave-core Shared observation envelope — schema contract used by all registries core/
behave-shell Shell-session behavioral observation registry BEHAVE-SHELL/
behave-text Text/messaging-domain behavioral observation registry BEHAVE-TEXT/

Install

All packages are available on PyPI:

pip install behave-core
pip install behave-shell
pip install behave-text

behave-core is pulled in automatically as a dependency of the registries.

For local development (includes pytest + ruff):

pip install -e "core/[dev]"
pip install -e "BEHAVE-SHELL/[dev]"
pip install -e "BEHAVE-TEXT/[dev]"

Test

pytest core/
pytest BEHAVE-SHELL/
pytest BEHAVE-TEXT/

Licensing

This repository uses a dual license:

Content License
Code, JSON schemas, tests (*.py, *.json, pyproject.toml) GNU GPL v3.0 or later
Spec prose and attribution recipes (*.md files) CC-BY-SA-4.0

SPDX identifiers are present in individual files.

Description
BEHAVE: The behavioral threat-actor profiling specification
Readme GPL-3.0 266 KiB
Languages
Python 100%