Documentation Index
Fetch the complete documentation index at: https://docs.orxhestra.com/llms.txt
Use this file to discover all available pages before exploring further.
Pick the path that matches how you want to work. The YAML tab is the shortest route for most users — the SDK tab is for when you need full programmatic control.
YAML (Composer)
Python SDK
Install
pip install 'orxhestra[cli,anthropic]'
export ANTHROPIC_API_KEY=sk-ant-...
Save orx.yaml
defaults:
model:
provider: anthropic
name: claude-opus-4-7
agents:
assistant:
type: llm
instructions: "You are a helpful weather assistant."
main_agent: assistant
Run it
Drops you into an interactive REPL with your agent as the root. Type a question, watch the stream. /help lists the slash commands; /exit when done. Want to expose the same agent as an HTTP server?orx orx.yaml --serve -p 9000
:9000. See Integrations → A2A for the wire format. Want signed events and an audit log? Opt in with a single flag or YAML block:orx identity init --path ./keys/agent.key
orx orx.yaml --identity ./keys/agent.key
/session command show the active signer DID. See Composer → Identity, trust, and attestation. pip install 'orxhestra[anthropic]'
export ANTHROPIC_API_KEY=sk-ant-...
import asyncio
from langchain_anthropic import ChatAnthropic
from langchain_core.tools import tool
from orxhestra import LlmAgent, Runner, InMemorySessionService
@tool
def get_weather(city: str) -> str:
"""Get the current weather for a city."""
return f"The weather in {city} is sunny and 22 degrees."
agent = LlmAgent(
name="WeatherAgent",
model=ChatAnthropic(model="claude-opus-4-7"),
tools=[get_weather],
instructions="You are a helpful weather assistant.",
)
runner = Runner(
agent=agent,
app_name="demo",
session_service=InMemorySessionService(),
)
async def main():
async for event in runner.astream(
user_id="user-1",
session_id="session-1",
new_message="What's the weather in Copenhagen and Berlin?",
):
if event.is_final_response():
print(event.text)
asyncio.run(main())
uv run python basic_agent.py
Next steps
