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.0rc1.tar.gz (41.1 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.0rc1-py3-none-any.whl (47.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: dreadnode-1.0.0rc1.tar.gz
  • Upload date:
  • Size: 41.1 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.0rc1.tar.gz
Algorithm Hash digest
SHA256 baae22ca6b82df694dfaff7cb1e468324adf5fbcbc939b10ec5c53b040f1012b
MD5 6dc93613e7a8884c90ec62d6ad53f974
BLAKE2b-256 3b8208999ce945235529df734da72574a20465b2755332bd870a8a94b133be83

See more details on using hashes here.

Provenance

The following attestation bundles were made for dreadnode-1.0.0rc1.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.0rc1-py3-none-any.whl.

File metadata

  • Download URL: dreadnode-1.0.0rc1-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.0rc1-py3-none-any.whl
Algorithm Hash digest
SHA256 c7ee62b2a817ca3a5c81fc1ac8f5ce9d64f56887955266bfce40cc1e0a123d5f
MD5 bf1551902135f13f85744a6504b3fcba
BLAKE2b-256 e8b8f6be20c53661cec0f3e9112ebe5c36413a5d1b36fe79c4633d2236ff18fb

See more details on using hashes here.

Provenance

The following attestation bundles were made for dreadnode-1.0.0rc1-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