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.
Related documentation
- Generated AgentCore reference
- Generated types and protocols reference
- Generated provider-wrapper reference
- Cross-package tool-host protocol
- Shared plugin development documentation
- Application and terminal documentation
Development
- Core Python development: implementation, configuration-composition, notification, logging, and maintainer guidance.