agentstack-sdk 0.7.1

Agent Stack SDK

Agent Stack Server SDK

Python SDK for packaging agents for deployment to Agent Stack infrastructure.

Overview

The agentstack-sdk provides Python utilities for wrapping agents built with any framework (LangChain, CrewAI, BeeAI Framework, etc.) for deployment on Agent Stack. It handles the A2A (Agent-to-Agent) protocol implementation, platform service integration, and runtime requirements so you can focus on agent logic.

Key Features

• Framework-Agnostic Deployment - Wrap agents from any framework for Agent Stack deployment
• A2A Protocol Support - Automatic handling of Agent-to-Agent communication
• Platform Service Integration - Connect to Agent Stack's managed LLM, embedding, file storage, and vector store services
• Context Storage - Manage data associated with conversation contexts

Installation

uv add agentstack-sdk

Quickstart

import os

from a2a.types import (
    Message,
)
from a2a.utils.message import get_message_text
from agentstack_sdk.server import Server
from agentstack_sdk.server.context import RunContext
from agentstack_sdk.a2a.types import AgentMessage

server = Server()

@server.agent()
async def example_agent(input: Message, context: RunContext):
    """Polite agent that greets the user"""
    hello_template: str = os.getenv("HELLO_TEMPLATE", "Ciao %s!")
    yield AgentMessage(text=hello_template % get_message_text(input))

def run():
    try:
        server.run(host=os.getenv("HOST", "127.0.0.1"), port=int(os.getenv("PORT", 8000)))
    except KeyboardInterrupt:
        pass


if __name__ == "__main__":
    run()

Run the agent:

uv run my_agent.py

Available Extensions

The SDK includes extension support for:

• Citations - Source attribution (CitationExtensionServer, CitationExtensionSpec)
• Trajectory - Agent decision logging (TrajectoryExtensionServer, TrajectoryExtensionSpec)
• Settings - User-configurable agent parameters (SettingsExtensionServer, SettingsExtensionSpec)
• LLM Services - Platform-managed language models (LLMServiceExtensionServer, LLMServiceExtensionSpec)
• Agent Details - Metadata and UI enhancements (AgentDetail)
• And more - See Documentation

Each extension provides both server-side handlers and A2A protocol specifications for seamless integration with Agent Stack's UI and infrastructure.

Resources

• Agent Stack Documentation
• GitHub Repository
• PyPI Package

Contributing

Contributions are welcome! Please see the Contributing Guide for details.

Support

• GitHub Issues
• GitHub Discussions

---

Developed by contributors to the BeeAI project, this initiative is part of the Linux Foundation AI & Data program. Its development follows open, collaborative, and community-driven practices.