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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.