assistableai (Python)

Official Python SDK and MCP server for the Assistable AI v3 API, generated from spec/openapi.json — the same source of truth as the TypeScript SDK, CLI, and MCP server.

  • SDK — typed operation functions + models (openapi-python-client: attrs + httpx) with a thin auth wrapper.
  • MCP server — every v3 operation as an MCP tool, via FastMCP's from_openapi (optional [mcp] extra).

Install

pip install assistableai            # SDK only
pip install 'assistableai[mcp]'     # SDK + MCP server

SDK usage

import assistableai
from assistableai.api.assistants import list_assistants, get_assistant
from assistableai.api.contacts import create_contact
from assistableai.models import ContactCreate  # example model

client = assistableai.configure(
    api_key="ask_live_…",
    subaccount_id="<subaccount-id>",   # sent as X-Subaccount-Id (optional)
)

# Every op exposes sync / sync_detailed / asyncio / asyncio_detailed.
# Responses are the full {data, error, request_id} envelope (a typed model).
envelope = list_assistants.sync(client=client.raw, limit=2)

# Need status codes / headers? Use *_detailed:
resp = get_assistant.sync_detailed("<assistant-id>", client=client.raw)
print(resp.status_code, resp.parsed)

# Per-call subaccount override:
list_assistants.sync(client=client.raw, x_subaccount_id="<other-subaccount>")

Credentials resolve from explicit args, then the environment (ASSISTABLE_API_KEY, ASSISTABLE_SUBACCOUNT_ID, ASSISTABLE_BASE_URL). Default base URL is https://api.assistable.ai.

configure() stores a process-global client (assistableai.get_client()); for multiple credentials, construct assistableai.AssistableAI(...) instances directly and pass .raw.

MCP server

ASSISTABLE_API_KEY=ask_live_… ASSISTABLE_SUBACCOUNT_ID=<id> assistableai-mcp
# or: python -m assistableai.mcp

Add to an MCP client (e.g. Claude Desktop):

{
  "mcpServers": {
    "assistableai": {
      "command": "assistableai-mcp",
      "env": {
        "ASSISTABLE_API_KEY": "ask_live_…",
        "ASSISTABLE_SUBACCOUNT_ID": "<subaccount-id>"
      }
    }
  }
}

Develop

uv sync --all-extras          # create the dev venv
uv run python scripts/generate.py   # regenerate assistableai._client from the spec
uv build                      # build wheel + sdist

The generated client (src/assistableai/_client) and the bundled spec (src/assistableai/spec/openapi.json) are committed; regenerate them whenever spec/openapi.json changes.

Project links

Data verified by PyPI on Aug 6, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for devassistable from gravatar.com devassistable

Credits

Author: Assistable AI

GitHub Statistics

Data verified by PyPI on Aug 6, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.10

Provides Extra

mcp

Tags

ai api assistable assistableai mcp sdk voice

Classifiers

Report project as malware

Download files

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

Source Distribution

assistableai-0.4.0.tar.gz (120.1 kB view details)

Uploaded Source

Built Distribution

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

assistableai-0.4.0-py3-none-any.whl (467.2 kB view details)

Uploaded Python 3

File details

Details for the file assistableai-0.4.0.tar.gz.

File metadata

  • Download URL: assistableai-0.4.0.tar.gz
  • Upload date:
  • Size: 120.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for assistableai-0.4.0.tar.gz
Algorithm Hash digest
SHA256 a1e2ad8eff52d0f3e680adcd315871ef4d1ee8497751c47678c2494cbd116307
MD5 6dc338ed770dd5bb2f04900de9966e8a
BLAKE2b-256 188e57b2cae11c83229d9afc4290e292669b10c326c3e65afd6cb75510ad5be7

See more details on using hashes here.

Provenance

The following attestation bundles were made for assistableai-0.4.0.tar.gz:

Publisher: release.yml on assistableai/assistableai-sdk

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

File details

Details for the file assistableai-0.4.0-py3-none-any.whl.

File metadata

  • Download URL: assistableai-0.4.0-py3-none-any.whl
  • Upload date:
  • Size: 467.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for assistableai-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e02ef06cf2dcf4e0057a1186b9e4a0221bc42c3c3afcaf19b90c84dc7ba38d62
MD5 0169e900d321aed0fe0263b29ed0fac6
BLAKE2b-256 c89bdb64c37265b5e3f60ddac7ce420c6d5480b3598b966eab64877944bde66a

See more details on using hashes here.

Provenance

The following attestation bundles were made for assistableai-0.4.0-py3-none-any.whl:

Publisher: release.yml on assistableai/assistableai-sdk

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

Release history Release notifications | RSS feed

This release

0.4.0 This release

2 files

0.3.0

2 files

0.2.0

2 files

0.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page