Skip to main content

Kagenti ADK

Project description

Kagenti ADK Server SDK

Python SDK for packaging agents for deployment to Kagenti ADK infrastructure.

PyPI version License LF AI & Data

Overview

The kagenti-adk provides Python utilities for wrapping agents built with any framework (LangChain, CrewAI, BeeAI Framework, etc.) for deployment on Kagenti ADK. 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 Kagenti ADK deployment
  • A2A Protocol Support - Automatic handling of Agent-to-Agent communication
  • Platform Service Integration - Connect to Kagenti ADK's managed LLM, embedding, file storage, and vector store services
  • Context Storage - Manage data associated with conversation contexts

Installation

uv add kagenti-adk

Quickstart

import os

from a2a.types import (
    Message,
)
from a2a.utils.message import get_message_text
from kagenti_adk.server import Server
from kagenti_adk.server.context import RunContext
from kagenti_adk.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 Kagenti ADK's UI and infrastructure.

Resources

Contributing

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

Support


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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kagenti_adk-0.8.0rc3.tar.gz (58.5 kB view details)

Uploaded Source

Built Distribution

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

kagenti_adk-0.8.0rc3-py3-none-any.whl (96.8 kB view details)

Uploaded Python 3

File details

Details for the file kagenti_adk-0.8.0rc3.tar.gz.

File metadata

  • Download URL: kagenti_adk-0.8.0rc3.tar.gz
  • Upload date:
  • Size: 58.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for kagenti_adk-0.8.0rc3.tar.gz
Algorithm Hash digest
SHA256 af3983909dee1d2e25c4f47fe30a234040d30865b50355f031a91f4a0a600d61
MD5 3953988f41e2d4f83ac6bd2069b758a6
BLAKE2b-256 12ca71fda68fa190553453ad4bf3dea5f4252a1b50978ddaca063d3db48eeec1

See more details on using hashes here.

Provenance

The following attestation bundles were made for kagenti_adk-0.8.0rc3.tar.gz:

Publisher: release.yml on kagenti/adk

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

File details

Details for the file kagenti_adk-0.8.0rc3-py3-none-any.whl.

File metadata

  • Download URL: kagenti_adk-0.8.0rc3-py3-none-any.whl
  • Upload date:
  • Size: 96.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for kagenti_adk-0.8.0rc3-py3-none-any.whl
Algorithm Hash digest
SHA256 06fb28d054288b97a41db7e4971990d9dd4c654b90075bfcd1edd8c433981b5a
MD5 066bb21865de9c3112036314076b1637
BLAKE2b-256 801a3d67975b2e71493f6a1ca59287e8e605365bd06d670bf1565080941c2b86

See more details on using hashes here.

Provenance

The following attestation bundles were made for kagenti_adk-0.8.0rc3-py3-none-any.whl:

Publisher: release.yml on kagenti/adk

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