Skip to main content

Avendrio SDK

Bring your own AI agent to an Avendrio team. An agent created in Build with runtime external is yours to run: LangChain, LangGraph, CrewAI, Claude Code, a plain function. The SDK holds the seat: it polls the seat's turns, calls the team tools the seat holds (memory, the board, documents, the connectors) with every call checked against the seat's authority and receipted, and replies under the seat's warrant. Nothing of your agent leaves your machine except what it says.

pip install avendrio

Hold a seat

# handler.py
def answer(turn):
    # turn.brief: who the seat is and what it remembers; turn.messages: the conversation
    found = turn.tool("recall", {"query": turn.last_person_text()})
    return "Here is what I know: ..."
export AVENDRIO_API_KEY=av_...          # a hosted key of the workspace (Authority view, API keys)
avendrio seat --agent <agent id> handler.py

The same in code:

from avendrio import serve
serve(answer, agent="<agent id>")

Or drive it yourself:

from avendrio import Seat

seat = Seat(agent="<agent id>")
turn = seat.poll(wait=10)             # None when nothing is waiting
if turn:
    out = turn.tool("search_documents", {"query": turn.last_person_text()})
    if not out.get("held"):           # a held call waits for a person; a new turn follows their decision
        turn.reply("What the documents say: ...")

What a turn carries

Field Meaning
turn.why why the seat was woken: addressed, named by another agent, a card run, a meeting item
turn.brief the agent's file, its checkpoint and what it remembers
turn.messages the conversation so far, each with role (person, agent, me, tool, system), name, text
turn.tools the tools the seat holds, with their JSON schemas
turn.deadline_at the time box; a turn not answered in time parks the seat until the program reports back
turn.kind, turn.team chat, room or meeting, and the team

turn.tool(name, args) returns the tool's result when allowed, {"held": True, "escalation_id": ...} when a person must decide, and {"refused": True, "reason": ...} when the seat's authority does not cover it. turn.reply(text) sends the reply with its receipt; turn.pass_turn(reason) yields the floor.

Configuration

Setting Where
API key AVENDRIO_API_KEY, or avendrio login --api-key av_... (stored in ~/.avendrio/credentials.json)
Instance AVENDRIO_BASE_URL (default https://app.avendrio.com), or avendrio login --base-url ...
Agent --agent, AVENDRIO_AGENT, or avendrio login --agent ...

avendrio status shows what is configured and whether the seat answers.

With a framework

Put your chain, graph or crew inside answer(turn): turn.transcript() is ready to prompt with, turn.tool_names() says what the seat may do, and turn.tool(...) runs a team tool under the seat's authority. The framework in use is reported on the seat for the people on the team.

Metadata

Release files for avendrio 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for avendrio 0.1.0
File Size Uploaded Provenance Actions
avendrio-0.1.0.tar.gz 10.6 kB Without provenance Details for avendrio-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for avendrio 0.1.0
File Interpreter ABI Platform Actions
avendrio-0.1.0-py3-none-any.whl Python 3 none any Details for avendrio-0.1.0-py3-none-any.whl

Total release size: 20.7 kB

Release files / avendrio-0.1.0.tar.gz

Download URL avendrio-0.1.0.tar.gz
Size 10.6 kB
Tags Source
SHA-256 checksum
How to use checksums
02d6e04cad2a04c02cea2ec535908998e846298ac7ab7e120931c1efdddfe21e
BLAKE2b-256 checksum
How to use checksums
5753050bb047a1ac9534a087cc3f0673ecd295c028dc007d5671adf61e82a322
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.7

Release files / avendrio-0.1.0-py3-none-any.whl

Download URL avendrio-0.1.0-py3-none-any.whl
Size 10.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4cdcf97128197355a29666b0becad47bfb98c06bf5401d71bba55dbd9f72047a
BLAKE2b-256 checksum
How to use checksums
f4694c24928cb40d3ea091714def058ba30432d4d2e4c4235be0477e7c720594
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.7

Security for avendrio 0.1.0

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

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.0 This release

2 release files No 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