agents24

Last Updated: 2026-05-25

Unified Python SDK for Agents24.

Endpoint methods are generated from packages/agents24-sdk-contract/agents24.sdk.json. Do not edit files under agents24/generated/ directly. For SDK maintenance, see docs/references/agents24_sdk_development_guide.md.

from agents24 import Agents24

client = Agents24(
    base_url="http://localhost:8000",
    api_key="tpk_...",
    organization_id="org-id",
    project_id="project-id",
)

agent = client.agent({
    "name": "Support Agent",
    "instructions": "Answer briefly.",
}).create()

client.agents.publish(agent["id"])

Published-Agent Runtime

Use client.embed from server code to call a published agent through the public embed runtime:

def on_event(event):
    print(event["event"])

result = client.embed.stream_agent(
    "published-agent-id",
    {
        "input": "Help me with my account.",
        "external_user_id": "customer-user-123",
    },
    on_event=on_event,
)

The namespace also includes thread list/detail/delete, run-context, cancel, and attachment-upload methods.

Artifact Authoring

Artifact code imports lightweight helpers from agents24.artifacts:

from pydantic import BaseModel, Field

from agents24.artifacts import tool


class EchoInput(BaseModel):
    text: str = Field(description="Text to echo.")


class EchoOutput(BaseModel):
    text: str


@tool(
    name="echo",
    input_schema=EchoInput,
    output_schema=EchoOutput,
)
async def echo(input, config, context):
    return {"text": input["text"]}

The agents24.artifacts module is transport-free and safe for artifact runtime code. If artifact code imports Pydantic, declare pydantic as an artifact dependency.

Development

pnpm run generate:sdk
pnpm run check:sdk-contract
pnpm run test:agents24-python

Generated endpoint methods must stay in parity with the TypeScript @agents24/sdk package.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.3.0)

1 maintainer

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

License

MIT

Requires

Python >=3.10

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

agents24-0.1.1.tar.gz (21.7 kB view details)

Uploaded Source

Built Distribution

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

agents24-0.1.1-py3-none-any.whl (17.3 kB view details)

Uploaded Python 3

File details

Details for the file agents24-0.1.1.tar.gz.

File metadata

  • Download URL: agents24-0.1.1.tar.gz
  • Upload date:
  • Size: 21.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for agents24-0.1.1.tar.gz
Algorithm Hash digest
SHA256 d4c05c5b3e1fd5702ec41fa70b4d26754e3ca3b42d4d9d0de0141e2eb1723eca
MD5 e87356d7f069078edf680eb3f4365d53
BLAKE2b-256 9c3671b0ef3e8dc6fbcc175e10e6192501f64d7c5619a085d85470a614111c1a

See more details on using hashes here.

Provenance

The following attestation bundles were made for agents24-0.1.1.tar.gz:

Publisher: agents24-sdk-release.yml on daniel5426/talmudpedia

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

File details

Details for the file agents24-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: agents24-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 17.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for agents24-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 322f1ffc1a6e41c2afaa8e8027a81343d2eaec19e7955214c2a326d69f36c835
MD5 4f39c6152abacf18be396a1ca0648ebe
BLAKE2b-256 3fd022d0c388f494206f069d498b3c80d319972657276fe89f81e0dbbdc65e42

See more details on using hashes here.

Provenance

The following attestation bundles were made for agents24-0.1.1-py3-none-any.whl:

Publisher: agents24-sdk-release.yml on daniel5426/talmudpedia

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

Supported by

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