vued 0.2.2

Lightweight Python SDK for the local-first Vued API

Vued Python SDK

Synchronous Python SDK for Vued cloud + local runtime APIs.

Use cloud APIs for auth, metadata mutations, signed audio, API keys, and webhooks. Use Vued headless or unlocked Vued Desktop for decrypted meetings, transcripts, and file names.

For Coding Agents

Use web-client/docs/vued-api-guide-for-coding-agents.md as the self-contained implementation reference. Use web-client/docs/vued-api-setup-prompt.md for a ready-to-paste agent prompt. Use web-client/docs/llms.txt as the docs index.

If you need decrypted meetings, transcripts, or file names, use the local runtime API, local SDK methods, or local MCP. Cloud endpoints intentionally do not return plaintext transcript content.

Install

pip install vued

For local decrypted methods, Vued() can use the scoped local SDK auth stored by Desktop or headless setup. For cloud methods, CI/server use, or an explicit override, set VUED_API_KEY or pass api_key="vued_live_...". If VUED_API_KEY is stale or belongs to another user, local methods fall back to the runtime-stored key; an explicit api_key=... remains a strict override.

Development:

cd vued-python-sdk
uv sync
uv run python examples/test_public_api.py

For local plaintext methods, the SDK uses a running Vued local runtime. If none is reachable, it starts installed headless Vued first, then falls back to Vued Desktop. Install/setup: https://docs.vued.ai/quickstart

Quick Start

See the commented guide at examples/quickstart.py for org discovery, local decrypted search, pagination, and signed audio.

from vued import Vued

client = Vued()

results = client.search("paid ads cost", limit=10)
meeting = client.get_meeting(results["items"][0]["meeting"]["id"])

print(meeting["meeting"]["title"])
print(meeting["transcript"]["text"])

Client

client = Vued(
    base_url="https://vued-office-api-dev.onrender.com/v1",
    timeout=30.0,
    auto_start_daemon=True,
)

Param	Type	Meaning
api_key	string | null	Optional vued_live_... public API key. Defaults to VUED_API_KEY. Local methods can omit it after Desktop or headless setup. Cloud methods require it.
org_id	string | null	Optional org override. Standard public API keys are scoped to one org and resolve automatically.
base_url	string	Cloud /v1 base URL.
timeout	float	HTTP timeout seconds.
auto_start_daemon	bool	Start installed headless Vued when local plaintext methods need it. Defaults to true.

Methods

Local plaintext methods require Vued headless or Vued Desktop:

client.search(q, type=None, include_transcript=True, limit=20)
client.semantic_search(q, type=None, limit=5)
client.list_meetings(
    type=None,
    started_after=None,
    started_before=None,
    room_id=None,
    microphone_id=None,
    file_id=None,
    limit=100,
    cursor=None,
)
client.get_meeting(meeting_id)
client.download_meeting(meeting_id, path=".")
client.get_transcript(transcript_id)
client.list_files(
    type=None,
    q=None,
    parent_id=None,
    root_only=None,
    visibility=None,
    record_id=None,
    created_after=None,
    created_before=None,
    updated_after=None,
    updated_before=None,
    sort=None,
    limit=50,
    cursor=None,
)
client.get_file(file_id)

Headless daemon helpers:

client.local_status()
client.ensure_daemon(start=True)

Runtime/account diagnostics:

status = client.local_status()
print(status["runtime"], status.get("email"), status["base_url"])
print(status.get("discovery"))

Cloud methods:

client.list_orgs(limit=50, cursor=None)

client.get_meeting_audio(meeting_id)
client.get_transcript_audio(transcript_id)

client.create_file(name="Folder", type="folder", parent_id=None, visibility="org")
client.update_file(file_id, name=None, parent_id=..., visibility=None)
client.list_file_grants(file_id, limit=50, cursor=None)
client.grant_file(file_id, user_id)
client.revoke_file_grant(file_id, user_id)

client.list_speakers(q=None, limit=50, cursor=None)
client.get_speaker(speaker_id)

client.list_rooms(q=None, limit=50, cursor=None)
client.get_room(room_id)
client.create_room(display_name="Conference Room", microphone_id="mic-1")
client.update_room(room_id, display_name=None, microphone_id=None, is_primary=None, participant_user_ids=None)
client.list_microphones(limit=50, cursor=None)
client.get_microphone(microphone_id)

client.list_users(q=None, limit=50, cursor=None)
client.get_user(user_id)

client.list_api_keys(limit=50, cursor=None)
client.create_api_key(name="Public API key", expires_at=None, scopes=None)
client.revoke_api_key(key_id)

client.list_webhooks(limit=50, cursor=None)
client.create_webhook(name="Webhook", url="https://example.com/vued", events=["meeting.finalized"])
client.update_webhook(webhook_id, name=None, url=None, events=None, payload_fields=None, disabled=None)
client.delete_webhook(webhook_id)

Audio URL responses include filename and mime; signed URLs include a .m4a download filename hint for M4A/AAC audio.

type is None, "manual", or "automatic".

sort for list_files is name_asc, name_desc, updated_at_asc, updated_at_desc, created_at_asc, created_at_desc, date_asc, or date_desc.

For update_file, omit parent_id to keep the parent, pass a folder ID to move, or pass None to move to root.

Return Contracts

Pages return:

{ "items": [], "next_cursor": null }

search returns:

{
  "items": [
    {
      "meeting": { "id": "...", "type": "manual", "title": "...", "started_at": "..." },
      "matches": [{ "event": { "id": "...", "text": "..." }, "snippet": "..." }]
    }
  ],
  "next_cursor": null
}

get_meeting returns:

{
  "meeting": { "id": "...", "object": "meeting", "type": "manual", "title": "..." },
  "transcript": {
    "text": "Speaker: hello",
    "events": [
      {
        "id": "...",
        "index": 0,
        "start": "2026-06-24T21:24:57.909Z",
        "end": "2026-06-24T21:24:58.228Z",
        "speaker": {
          "diarization_id": "speaker_1",
          "profile_id": null,
          "name": "Speaker 1",
          "type": "diarized"
        },
        "text": "Hello."
      }
    ]
  }
}

get_transcript returns:

{
  "event": { "id": "...", "speaker": { "name": "Speaker 1", "type": "diarized" }, "text": "Hello." },
  "meeting": { "id": "...", "type": "manual", "title": "...", "started_at": "..." }
}

Signed audio methods return:

{
  "available": true,
  "url": "https://...",
  "expires_at": 1782345900,
  "retention_days": 1,
  "offset_secs": { "start": 12.3, "end": 15.8 },
  "suggested_clip_secs": { "start": 9.3, "end": 18.8, "margin_secs": 3.0 }
}

Full route, parameter, scope, response, webhook, and MCP schemas live in:

web-client/docs/local-api-sdk-mcp.md

MCP

The SDK installs a local MCP stdio shim:

vued mcp

Development:

uv run vued mcp

The shim forwards MCP JSON-RPC to the active local runtime, either headless or Desktop, and exposes:

Tool	Purpose
search	Keyword search decrypted meetings/transcripts.
semantic_search	Semantic search with local plaintext hydration.
list_meetings	Browse decrypted meeting records.
get_meeting	Fetch one meeting plus transcript.
get_transcript	Fetch one transcript event plus meeting ref.

Headless Daemon

External agents can use Vued without Electron by running the standalone local runtime:

curl -fsSL https://vued.ai/install.sh | sh
vued setup

Running vued or any daemon command before setup starts the same guided setup flow. Interactive setup opens https://vued.ai/cli-auth in the browser, then hands the session and refresh token back to the local CLI callback. Headless refreshes expired Vued sessions automatically on cloud 401s. If refresh requires user action, vued status, vued doctor, and SDK local_status() surface the daemon auth_required state. To change accounts later, run:

vued setup --reset

Setup can also install the local MCP server into detected AI tools. Run this later if you skipped it during setup:

vued mcp install
vued mcp install --mcp-targets claude-code,codex,codex-desktop,claude-desktop,cursor

To remove the headless runtime and local cache:

vued uninstall

Development from this repo:

cd web-client
npm run headless:doctor
npm run headless:start

The daemon writes the same local-api.json discovery file used by the SDK and MCP, so local plaintext SDK methods continue to work against either Desktop or headless.

Errors

from vued import Vued, VuedError, VuedLocalUnavailableError

try:
    client = Vued()
    client.search("pricing")
except VuedLocalUnavailableError:
    print("Install/setup Vued from https://docs.vued.ai/quickstart")
except VuedError as err:
    print(err.status_code, err.body)

Error	Meaning
VuedError	HTTP failure, non-2xx response, or network error.
VuedLocalUnavailableError	Local runtime is missing, not set up, locked, or unavailable.