Skip to main content

crewai-botsrated

One-click attach

Coding agents: the stack-by-stack attach recipe is llms-install.md → When scaffolding x402 pay (also a Cursor rule and an agent skill). The default path these attaches follow is docs/guard/default-middleware.md.

Free. No key for local attach. Pairs with the host runtime. Not a second runtime. Published on PyPI. Paid checks are not required to attach.

pip install crewai-botsrated
from crewai_botsrated import attach_payment_guard
guard = attach_payment_guard(x402_client)  # omit preset = advice; omit fail_mode = open

Preflight and the guard surface signed receipt links (receipt_url). When org ledger is enabled, paid checks write there by default. No custody. Facts, not grades.

Attach is pair-with. Free. No key for local attach. Not a second runtime.

Live docs: botsrated.com/docs/guard#crewai.

Default install

Free. No key for local attach. Pairs with CrewAI. Payment-client wrap and an optional before-pay tool hook. Not a crew, process, flow, or agent loop. The guard is not a runtime. Published: pip install crewai-botsrated (PyPI 0.1.1; dependency botsrated>=0.3.1,<0.4). Installing does not attach a guard. Paid checks are not required to attach. Optional BOTSRATED_TOKEN for Desk remote policy (omit token and the guard reads the env).

# Free. No key for local attach. Not a runtime.
# Optional BOTSRATED_TOKEN for Desk remote policy.
from crewai_botsrated import attach_payment_guard
# Omit preset = advice. Omit fail_mode = open.
guard = attach_payment_guard(x402_client)

It does not sign a payment and does not hold funds.

Install in 3 steps

  1. Free. No key for local attach. Install: pip install crewai-botsrated (PyPI 0.1.1, includes attach_payment_guard). Depends on botsrated>=0.3.1,<0.4. Paid checks are not required to attach.
  2. Attach to your x402 client. Installing does not attach a guard:
from crewai_botsrated import attach_payment_guard
guard = attach_payment_guard(x402_client)
  1. Omit preset for advice only (carefulBuyer / strict stop an unobserved payTo when you pass them). Omit fail_mode to stay open. "closed" stops the payment when BotsRated or your policy cannot answer. A missing decision is never a pass. A remote pass never clears a local block.

BOTSRATED_TOKEN is optional. Omit token and the guard reads BOTSRATED_TOKEN. On botsrated 0.3.0 and later it is sent only as remote_policy={"token", "fail_mode"}, never as a bare string. A configured token on a core without parse_remote_policy raises and is not dropped. The policy decision is not signed. Get a token in Desk.

Omit fail_mode and the guard stays open. "closed" stops the payment when BotsRated or your policy cannot answer. A missing decision is never a pass. A remote pass never clears a local block. Nothing defaults you to closed.

CrewAI hook for BotsRated. Use it as a pre-payment check before an agent pays an x402 seller. CrewAI stays the crew runtime. This package is not a crew, process, flow, or agent loop.

Status: published on PyPI: crewai-botsrated 0.1.1 (this release; includes attach_payment_guard). Depends on botsrated >=0.3.1,<0.4 (source: integrations/python-core). PyPI 0.1.1 matches that pin. Omit token and attach_payment_guard reads BOTSRATED_TOKEN.

pip install crewai-botsrated

Contributors in a checkout of this repository can install this tree with pip install -e integrations/crewai. The published install is pip install crewai-botsrated.

Before-pay hook and token

register_botsrated_pre_tool_hook(guard, paid_tools={"pay_seller"}) registers CrewAI PRE_TOOL_CALL (@on(InterceptionPoint.PRE_TOOL_CALL)). On a block it raises HookAborted(reason=..., source="botsrated") and does not run that tool. Older CrewAI uses @before_tool_call and returns False. Tools that are not named are left alone. botsrated_preflight(url) is the free preflight and does not attach a guard.

BOTSRATED_TOKEN is optional. Omit token and the guard reads BOTSRATED_TOKEN. On botsrated 0.3.0 and later it is sent only as remote_policy={"token", "fail_mode"}, never as a bare string. A configured token on a core without parse_remote_policy raises and is not dropped. The policy decision is not signed. Get a token in Desk.

Tests: pytest -m "not live" in this directory. They do not kick off a crew.

Metadata

Release files for crewai-botsrated 0.1.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 crewai-botsrated 0.1.1
File Size Uploaded Provenance Actions
crewai_botsrated-0.1.1.tar.gz 14.9 kB With provenance Details for crewai_botsrated-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for crewai-botsrated 0.1.1
File Interpreter ABI Platform Actions
crewai_botsrated-0.1.1-py3-none-any.whl Python 3 none any Details for crewai_botsrated-0.1.1-py3-none-any.whl

Total release size: 24.3 kB

Release files / crewai_botsrated-0.1.1.tar.gz

Download URL crewai_botsrated-0.1.1.tar.gz
Size 14.9 kB
Tags Source
SHA-256 checksum
How to use checksums
edf38e3ae41f95411eb49926209dd8ae1c0fb125d373311a80032ba4221337dc
BLAKE2b-256 checksum
How to use checksums
23add232f95843324082e6c66f453abc441d400dca19292f0533fc5dda7ad2bd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 4, 2026.

Transparency log

Release files / crewai_botsrated-0.1.1-py3-none-any.whl

Download URL crewai_botsrated-0.1.1-py3-none-any.whl
Size 9.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ba2072f7f10c49e7ebe4b03c76264375c88c78b424f1d933d8bf0622fd9171ae
BLAKE2b-256 checksum
How to use checksums
d56549fb7a72c4c8baebd9ff5d575ad08335952587499078487ed7e66bf2733b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 4, 2026.

Transparency log

Security for crewai-botsrated 0.1.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 crewai_botsrated-0.1.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 4, 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.1.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