ARK Python SDK
Python SDK for ARK - Agentic Runtime for Kubernetes. This SDK is part of the open source Agents at Scale ARK project.
This package provides Python bindings for managing ARK agents, models, queries, and other resources in Kubernetes. It is partly generated from the ARK Custom Resource Definitions (CRDs), with additional capabilities layered on top.
Installation
pip install ark-sdk
Usage
Kubernetes Resource Management
from ark_sdk import ARKClientV1alpha1
from ark_sdk.models.agent_v1alpha1 import AgentV1alpha1, AgentV1alpha1Spec
# Initialize client
client = ARKClientV1alpha1(namespace="default")
# Create agent
agent = AgentV1alpha1(
metadata={"name": "my-agent"},
spec=AgentV1alpha1Spec(prompt="Hello", modelRef={"name": "gpt-4"})
)
created = client.agents.create(agent)
# Get, update, delete
agent = client.agents.get("my-agent")
agent.spec.prompt = "Updated"
client.agents.update(agent)
client.agents.delete("my-agent")
Execution Engine Development
The SDK now includes utilities for building execution engines:
from ark_sdk import BaseExecutor, ExecutorApp, ExecutionEngineRequest, Message
class MyExecutor(BaseExecutor):
def __init__(self):
super().__init__("MyEngine")
async def execute_agent(self, request: ExecutionEngineRequest) -> List[Message]:
# Your execution logic here
return [Message(role="assistant", content="Hello from my engine!")]
# Create and run the executor
executor = MyExecutor()
app = ExecutorApp(executor, "MyEngine")
app.run(host="0.0.0.0", port=8000)
Async Operations
# List agents asynchronously
agents = await client.agents.a_list()
# Create query asynchronously
query = await client.queries.a_create(QueryV1alpha1(...))
Execution Engine Types
The SDK provides common types for execution engines:
ExecutionEngineRequest- Request format for agent executionExecutionEngineResponse- Response format from execution enginesAgentConfig- Agent configuration structureMessage- Chat message formatBaseExecutor- Abstract base class for execution enginesExecutorApp- FastAPI application setup for execution engines
Documentation
For full documentation and examples, visit the ARK project repository.
Requirements
- Python 3.9+
- Kubernetes cluster with ARK installed
- FastAPI and uvicorn (for execution engine development)
1 maintainer
Metadata
1 maintainer
Release files for ark-sdk 0.1.69
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ark_sdk-0.1.69-py3-none-any.whl | Python 3 | none | any | Details |
Release files / ark_sdk-0.1.69-py3-none-any.whl
| Download URL | ark_sdk-0.1.69-py3-none-any.whl |
|---|---|
| Size | 242.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
035e3d691f3e9ffa627cd43d63750efb27bf7ae681d470d36f1cecb8571b0bee
|
|
BLAKE2b-256 checksum How to use checksums |
5063056b95ad8680e64c620ad7b0553d7bd060367f39c68acd230ad92dcfac44
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
