Python SDK

BeeOS publishes two related Python packages:

Package	Purpose
`beeos`	Recommended official entry point and stable facade.
`beeos-sdk`	Complete OpenAPI-generated client, imported as `beeos_sdk`.

Both target the Platform OpenAPI at https://openapi.beeos.ai. They do not wrap the separate A2A or MCP protocols.

Install

python -m pip install beeos

The beeos package installs a compatible beeos-sdk dependency. Install beeos-sdk directly only when generated-client imports are preferred. Application deployments should pin the resolved versions in their lockfile. The documentation intentionally does not hard-code patch versions, so package releases do not require a documentation-only update.

Configure

import os
import beeos

configuration = beeos.Configuration(
    host="https://openapi.beeos.ai",
    access_token=os.environ["BEEOS_API_KEY"],
)

Authentication uses the same user JWT or oag_ User API Key as the other OpenAPI SDKs.

Create an async task

import beeos

with beeos.ApiClient(configuration) as client:
    tasks = beeos.sdk.TasksApi(client)
    response = tasks.create_task(
        agent_id="agent_abc123",
        create_task_request=beeos.sdk.CreateTaskRequest(
            message="Open Settings",
        ),
    )
    print(response.data.task_id)

Use beeos.sdk for the complete generated API and model surface. The equivalent direct imports are available from beeos_sdk:

import beeos_sdk

configuration = beeos_sdk.Configuration(
    host="https://openapi.beeos.ai",
    access_token="oag_...",
)

Generation and compatibility

beeos-sdk is generated from the same beeos-platform-v1.yaml contract as the TypeScript and Go clients. Generated classes and method names may change when the OpenAPI contract has a breaking release; use the official beeos facade for the stable top-level imports.

Getting Started

Guides

Architecture

A2A Protocol

MCP

Integrations

SDKs

Reference

Install

Configure

Create an async task

Generation and compatibility

​Install

​Configure

​Create an async task

​Generation and compatibility

Install

Configure

Create an async task

Generation and compatibility