Agent Lifecycle Toolkit

0.10.1 verified Mon Apr 27 auth: no python

The Agent Lifecycle Toolkit (ALTK) is a library of components to help agent builders improve their agent with minimal integration effort and setup. Current version 0.10.1, requires Python >=3.10, maintained by Anthropic. Release cadence: active development.

pip install agent-lifecycle-toolkit

Common errors

error ModuleNotFoundError: No module named 'agent_lifecycle_toolkit' ↓

cause Package not installed or installed under different name

fix

Run pip install agent-lifecycle-toolkit (note hyphens, not underscores)

error ValueError: API key not provided. Set ALTK_API_KEY environment variable or pass api_key. ↓

cause Missing authentication credential

fix

Set environment variable export ALTK_API_KEY=your_key or instantiate with AgentLifecycleClient(api_key='your_key')

error AttributeError: module 'agent_lifecycle_toolkit' has no attribute 'AgentLifecycleClient' ↓

cause Outdated package version (<0.9.0) where client was in submodule

fix

Upgrade to latest version: pip install --upgrade agent-lifecycle-toolkit

Warnings

breaking API base URL changed in 0.10.0 from https://app.altk.dev to https://api.altk.dev ↓

fix Update base_url to https://api.altk.dev

deprecated The `create_agent` method is deprecated in 0.10.x, use `register_agent` instead ↓

fix Replace client.create_agent(...) with client.register_agent(...)

breaking Python 3.9 support dropped in 0.10.0 ↓

fix Upgrade to Python >=3.10

gotcha Environment variable `ALTK_API_KEY` is read at client init; if not set and no api_key passed, client raises ValueError with unclear message ↓

fix Always set ALTK_API_KEY or pass api_key parameter explicitly

Imports

AgentLifecycleClient

wrong

from agent_lifecycle_toolkit.client import AgentLifecycleClient

correct

from agent_lifecycle_toolkit import AgentLifecycleClient

Incorrect path; top-level access is correct

AgentLifecycleMiddleware

wrong

from agent_lifecycle_toolkit.middleware import AgentLifecycleMiddleware

correct

from agent_lifecycle_toolkit import AgentLifecycleMiddleware

Incorrect path; exported at package level

Message

wrong

from agent_lifecycle_toolkit.types import Message

correct

from agent_lifecycle_toolkit import Message

Message is re-exported at top level

Quickstart

Initialize the ALTK client and create a session.

import os
from agent_lifecycle_toolkit import AgentLifecycleClient

client = AgentLifecycleClient(api_key=os.environ.get('ALTK_API_KEY', ''), base_url="https://api.altk.dev")
# Example: start a session
session = client.create_session(agent_id="my-agent")
print(f"Session ID: {session.id}")