pip install omnicoreagent

export LLM_API_KEY=your_api_key_here

import asyncio
from omnicoreagent import OmniCoreAgent

async def main():
    agent = OmniCoreAgent(
        name="my_agent",
        system_instruction="You are a helpful assistant.",
        model_config={"provider": "openai", "model": "gpt-5.6-terra"},
    )
    result = await agent.run("Hello! In one sentence, what can you do?")
    print(result["response"])
    await agent.cleanup()

asyncio.run(main())

I can answer questions, research and analyze information, create or edit workspace files, and help plan, write, troubleshoot, and complete tasks accurately.

import asyncio
from omnicoreagent import OmniCoreAgent, ToolRegistry

tools = ToolRegistry()

@tools.register_tool("get_weather")
def get_weather(city: str) -> dict:
    """Get current weather for a city."""
    return {"city": city, "temp": "22C", "condition": "Sunny"}

async def main():
    agent = OmniCoreAgent(
        name="weather_agent",
        system_instruction="Use tools when they help answer the user. Answer in plain text.",
        model_config={"provider": "openai", "model": "gpt-5.6-terra"},
        local_tools=tools,
    )
    result = await agent.run("What's the weather in Tokyo?")
    print(result["response"])

    trajectory = await agent.get_trajectory(result["trace_id"])
    for step in trajectory["steps"]:
        for call in step["tool_calls"]:
            print("step", step["step"], "->", call["tool_name"], call["arguments"], call["outcome"])
    print("totals:", {k: trajectory["totals"].get(k) for k in ("steps", "tokens", "estimated_cost_usd")})

    await agent.cleanup()

asyncio.run(main())

Tokyo is currently sunny, with a temperature of 22°C.
step 1 -> get_weather {'city': 'Tokyo'} success
totals: {'steps': 2, 'tokens': {'input': 3017, 'output': 35, 'total': 3052, 'cached_input': 1466, 'reasoning': 0}, 'estimated_cost_usd': 0.0045877}

await agent.run("My name is Ada and I like short answers.", session_id="user_123")
result = await agent.run("What is my name?", session_id="user_123")
print(result["response"])

other = await agent.run("What is my name?", session_id="someone_else")
print(other["response"])

Ada.
I don’t know your name—you haven’t told me.