Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.auriko.ai/llms.txt

Use this file to discover all available pages before exploring further.

Use Auriko as your LLM provider in Google’s Agent Development Kit (ADK). This integration is Python-only. For TypeScript, use the Vercel AI SDK integration.

​
Prerequisites

​
Install

pip install "auriko[adk]"

​
Use SDK adapter

Use the AurikoLlm adapter: 
from auriko.frameworks.adk import AurikoLlm

llm = AurikoLlm(model="gpt-5.4")
AurikoLlm is a native BaseLlm implementation that supports text and function calling. It maps OpenAI API errors to typed Auriko error classes. 
import asyncio
from auriko.frameworks.adk import AurikoLlm
from google.adk import Agent, Runner
from google.adk.sessions import InMemorySessionService
from google.genai import types

llm = AurikoLlm(model="gpt-5.4")

agent = Agent(
    model=llm,
    name="assistant",
    instruction="You are a helpful assistant.",
)

session_service = InMemorySessionService()
runner = Runner(agent=agent, app_name="my_app", session_service=session_service, auto_create_session=True)

user_message = types.Content(
    role="user", parts=[types.Part(text="What is 2+2?")]
)

async def main():
    async for event in runner.run_async(user_id="user-1", session_id="session-1", new_message=user_message):
        if event.content and event.content.parts:
            for part in event.content.parts:
                if part.text:
                    print(part.text, end="", flush=True)

asyncio.run(main())
inline_data and file_data parts raise NotImplementedError.

​
Configure options

ParameterTypeDefaultDescription
modelstr(required)Model ID
api_keystrAURIKO_API_KEY envAPI key
routingRoutingOptions | NoneNoneRouting configuration
base_urlstr"https://api.auriko.ai/v1"API base URL

​
Configure routing

Pass a RoutingOptions instance to control routing: 
from auriko.frameworks.adk import AurikoLlm
from auriko.route_types import RoutingOptions

llm = AurikoLlm(
    model="gpt-5.4",
    routing=RoutingOptions(optimize="cost"),
)

​
Configure manually

If you prefer to use Google’s LiteLlm class directly:
import os
from google.adk.models.lite_llm import LiteLlm

llm = LiteLlm(
    model="openai/gpt-5.4",
    api_key=os.environ["AURIKO_API_KEY"],
    api_base="https://api.auriko.ai/v1",
    custom_llm_provider="openai",
)
LiteLLM ignores api_base for model names containing provider keywords (like gpt or claude). Always include custom_llm_provider="openai" to force LiteLLM to respect your custom base URL.
For routing options and typed error mapping, use AurikoLlm.