Skip to main content

Dreadnode SDK

Project description

Logo

Dreadnode Strikes SDK

PyPI - Python Version PyPI - Version GitHub License Tests Pre-Commit Renovate


Strikes is an platform for building, experimenting with, and evaluating AI security agent code.

  • Experiment + Tasking + Observability in a single place that's lightweight and scales.
  • Track your data with parameters, inputs, and outputs all connected to your tasks.
  • Measure everything with metrics throughout your code and anywhere you need them.
  • Scale your code from a single run to thousands.
import dreadnode as dn
import rigging as rg

from .tools import reversing_tools

dn.configure()

@dataclass
class Finding:
    name: str
    severity: str
    description: str
    exploit_code: str

@dn.scorer(name="Score Finding")
async def score_finding(finding: Finding) -> float:
    if finding.severity == "critical":
        return 1.0
    elif finding.severity == "high":
        return 0.8
    else:
        return 0.2

@dn.task(scorers=[score_finding])
@rg.prompt(tools=[reversing_tools])
async def analyze_binary(binary: str) -> list[Finding]:
    """
    Analyze the binary for vulnerabilities.
    """
    ...

with dn.run(tags=["reverse-engineering"]):
    binary = "c2/downloads/service.exe"

    dn.log_params(
        model="gpt-4",
        temperature=0.5,
        binary=binary
    )

    findings = await analyze_binary(binary)

    dn.log_metric("findings", len(findings))

Installation

We publish every version to PyPi:

pip install -U dreadnode

If you want to build from source:

poetry install

See our installation guide for more options.

Getting Started

Read through our introduction guide in the docs.

Examples

Check out dreadnode/example-agents to find your favorite use case.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dreadnode-1.0.0rc0.tar.gz (41.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

dreadnode-1.0.0rc0-py3-none-any.whl (47.1 kB view details)

Uploaded Python 3

File details

Details for the file dreadnode-1.0.0rc0.tar.gz.

File metadata

  • Download URL: dreadnode-1.0.0rc0.tar.gz
  • Upload date:
  • Size: 41.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for dreadnode-1.0.0rc0.tar.gz
Algorithm Hash digest
SHA256 18e2a3a924a4500ad2376867ada0b679086b7e1cdd53a4607639010ff734f56a
MD5 3ede1f26cedce98d70d539a079972deb
BLAKE2b-256 fb6e4da2faaccee796d3598a77128e9bc2c7aef8ac3df6bd5c2f3998f62da7de

See more details on using hashes here.

Provenance

The following attestation bundles were made for dreadnode-1.0.0rc0.tar.gz:

Publisher: publish.yaml on dreadnode/sdk

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file dreadnode-1.0.0rc0-py3-none-any.whl.

File metadata

  • Download URL: dreadnode-1.0.0rc0-py3-none-any.whl
  • Upload date:
  • Size: 47.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for dreadnode-1.0.0rc0-py3-none-any.whl
Algorithm Hash digest
SHA256 eef5556afb468ec29f58666f23b1d4c578a3b7706b7e1866482a90cfa5489d22
MD5 cf9c275f94b82c90e75d3b5aebe5df16
BLAKE2b-256 0bb48b47030aff867659fa1739d65597093af7bf461489996bb092a7e43d23e4

See more details on using hashes here.

Provenance

The following attestation bundles were made for dreadnode-1.0.0rc0-py3-none-any.whl:

Publisher: publish.yaml on dreadnode/sdk

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page