Skip to content

Core Python documentation

The agent-core distribution contains the provider-agnostic agent_core SDK, the agent_app application orchestration layer, and a small collection of package-local compatibility plugins.

The SDK manages immutable conversation values, provider and plugin orchestration, synchronous and streaming requests, provider-native history, tool interoperability, and session operations. Applications remain responsible for choosing configuration and persisting sessions.

Start here

  • Quickstart: install from a source checkout and complete a deterministic request without credentials or network access.
  • Core SDK guide: use selected session, request, streaming, tool, action, import, and export APIs.
  • Core types and plugin protocols: understand the important values, plugin families, state ownership, request flow, and native-history model.
  • Application events: event storage, request/tool events, notification events, terminal additions, and transport boundaries.
  • Tested examples: generated catalog of runnable providers, extensions, features, tools, application flows, and integrations.
  • Package README: package boundaries, installation, tests, and project metadata.

Development

  • Core Python development: implementation, configuration-composition, notification, logging, and maintainer guidance.