Warning: this file needs updating

twiml-voice-agents

Why Use twiml-voice-agents

Configuring an agent is fairly simple and easy.

Limitations

The twiml-voice-agents package is limited by the fact that it supports half-duplex communication.

Half-duplex means that both a caller and the agent can speak, but only one at a time. The caller can interrupt the agent (technical name for this is barge-in). However, due to the nature of TwiML apps, there is a time when caller input will be lost. That period begins when Twilio detects an end-of-turn for the caller and awaits a response from your twiml-voice-agents server.

Minimal Usage

Installing

Run python3 -m pip install twiml-voice-agents

Setup

Anthropic

Get an Anthropic API key.

Set the ANTHROPIC_API_KEY environment variable to your API key.

Square

Get a Square OAuth Token with the following permissions: ...

Set the SQUARE_ACCESS_TOKEN environment variable to your OAuth token

Ngrok

Get an ngrok token

Set the NGROK_AUTHTOKEN environment variable to your auth token

Twilio Telephony

Set up a Twilio phone number to handle incoming calls with a TwiML webhook of your choice. Set the webhook URL to the ngrok domain along with path /call. Set the HTTP method to POST.

Running Server

import twiml_voice_agents as tva
srvr = tva.Server(tva.SquareSchedulingAgent)
srvr.run()

Talking to Agent, Finally

Lastly, call the Twilio phone number you configured.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

twiml_voice_agents-0.1.22.tar.gz (14.0 kB view details)

Uploaded Aug 30, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

twiml_voice_agents-0.1.22-py3-none-any.whl (19.0 kB view details)

Uploaded Aug 30, 2026 Python 3

File details

Details for the file twiml_voice_agents-0.1.22.tar.gz.

File metadata

Download URL: twiml_voice_agents-0.1.22.tar.gz
Upload date: Aug 30, 2026
Size: 14.0 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for twiml_voice_agents-0.1.22.tar.gz
Algorithm	Hash digest
SHA256	`95213f0530b024d0e10cebbef9c0ec69025231edf21cc53d25420077c3fec2a8`
MD5	`779801e1682a940ca0fd80f2d9df2e15`
BLAKE2b-256	`be39941add6068c20a4d7e87f0769f69b3c5d2f1f4c18473d1a352842d2dff22`

See more details on using hashes here.

Provenance

The following attestation bundles were made for twiml_voice_agents-0.1.22.tar.gz:

Publisher: publish.yml on Peter-Bergman/twiml-voice-agents

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: twiml_voice_agents-0.1.22.tar.gz
- Subject digest: 95213f0530b024d0e10cebbef9c0ec69025231edf21cc53d25420077c3fec2a8
- Sigstore transparency entry: 2647232571
- Sigstore integration time: Aug 30, 2026
Source repository:
- Permalink: Peter-Bergman/twiml-voice-agents@598966975c13244e0a49bb59374b6db0276468ef
- Branch / Tag: refs/heads/main
- Owner: https://github.com/Peter-Bergman
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@598966975c13244e0a49bb59374b6db0276468ef
- Trigger Event: workflow_dispatch