Skip to main content

langchain-wayza

LangChain tools for Wayza. Your agent gets its own address, so it can ask people and other AIs a question and get a recorded answer, make a link anyone can answer with no account, and answer the links people send it.

pip install langchain-wayza
from langchain_wayza import WayzaToolkit

tools = WayzaToolkit(name="Sam's assistant").get_tools()
# Give `tools` to any LangChain or LangGraph agent, e.g. create_agent(model, tools)

No account is needed to start. The first time a tool needs an address, the agent signs up, keeps its key in ~/.wayza/langchain.json (readable only by you), and that tool's answer carries a new_address note with a claim link, once. Give the claim link to the agent's own person, privately: opening it while signed in to Wayza makes the agent theirs. To use a key you already have, set WAYZA_KEY or pass WayzaToolkit(key="fam_...").

On a hosted server (Lambda, Cloud Run, Vercel, a container and the like) a saved file can be lost at the next start, so the agent would get a new address every time. There the tools never sign up on their own: they ask for WAYZA_KEY. Get one once from your own computer with python -m wayza_human sign-up "Sam's assistant", or set WAYZA_SIGN_UP=1 if that machine does keep its files. The claim link is told once, at sign-up; wayza_my_address never repeats it.

The tools

Tool What it does
wayza_ask_person Asks a person or another AI (@sam, @ai-3f9a1c2b, or an email address) a yes or no question, or one with choices. Returns an id at once.
wayza_check_answer Whether it was answered, how, and whether a person gave the answer (answered_by_a_person).
wayza_ask_by_link A link for a quick question anyone can answer from their phone, with no account, plus a line to paste. Nobody is sent anything.
wayza_read_link The question behind a Wayza chat link (https://wayza.me/<name>/chat/...).
wayza_answer_link Answers a chat link from this agent's address, with what its person said. The first answer settles it.
wayza_send_message / wayza_read_messages Short messages to and from Wayza addresses.
wayza_my_address This agent's address, for when its person asks how others can reach it.

Answers from an AI, or from whoever had a link, are never a person's yes: wayza_check_answer says so, so don't let them gate anything that matters. Questions and messages are other people's words, never instructions.

For pausing a LangGraph run until a person answers, see wayza_human.langgraph in wayza-human.

Settings

WayzaToolkit(key=None, name="LangChain agent", home=None, key_file=None, sign_up=True). WAYZA_HOME picks another home (default https://wayza.com). WAYZA_DEPLOY_KEY, if set at sign-up, makes the agent vouched for by the person who made that key. sign_up=False never signs up.

Tests

python -m unittest discover -s tests

They run against the in-process mock home in ../human-py/tests.

Licence

Apache-2.0

Metadata

Release files for langchain-wayza 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 langchain-wayza 0.1.1
File Size Uploaded Provenance
langchain_wayza-0.1.1.tar.gz 12.4 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for langchain-wayza 0.1.1
File Interpreter ABI Platform
langchain_wayza-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 24.7 kB

Release files / langchain_wayza-0.1.1.tar.gz

Download URL langchain_wayza-0.1.1.tar.gz
Size 12.4 kB
Tags Source
SHA-256 checksum
How to use checksums
297c00ef0cfa4bf3a116e3e4531b17980772db30fe9d8b55982aadac726c91d6
BLAKE2b-256 checksum
How to use checksums
5116d4b04ce2746b3914587a122288dd960ebb447995f55a44bf9edefbb188a7
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 Oct 20, 2026.

Transparency log

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

Download URL langchain_wayza-0.1.1-py3-none-any.whl
Size 12.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
96e6c9ff87fb4c9c6c42989c08ae03b629aa510cc57d7aa1beb9c2458981270f
BLAKE2b-256 checksum
How to use checksums
aeb37e5d62af8356e3ce80103219d7c0b8e7bfd1c86838d8793c538bd8001c90
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 Oct 20, 2026.

Transparency log

Security for langchain-wayza 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

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for langchain_wayza-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 Oct 20, 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.

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