- YAML (Composer)
- Python SDK
1
Install
2
Save orx.yaml
orx.yaml
3
Run it
/help lists the slash commands; /exit when done.Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Build and run your first orxhestra agent in under five minutes — as a YAML file you run from the terminal, or as Python code.
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
orx orx.yaml
/help lists the slash commands; /exit when done.orx orx.yaml --serve -p 9000
:9000. See Integrations → A2A for the wire format.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
Was this page helpful?