Documentation

import asyncio, os, cartha

cartha.init(
    api_key=os.environ["CARTHA_API_KEY"],
    api_base="https://cartha.in",
)

@cartha.tool()
def lookup_order(order_id: str) -> dict:
    return {"order_id": order_id, "status": "shipped"}

@cartha.trace(id="support_agent", team="support", budget_usd=1.0)
async def handle(user_id: str, question: str) -> str:
    order = lookup_order("ORD-1")
    reply = f"Order {order['order_id']} is {order['status']}."
    await cartha.llm_call(
        model="mock",
        input=question,
        output=reply,
        tokens_in=10,
        tokens_out=20,
        total_cost_usd=0.0001,
    )
    return reply

if __name__ == "__main__":
    print(asyncio.run(handle("user_1", "Where is my order?")))
    print("→ https://cartha.in → Traces")

import os, cartha

cartha.init(api_key=os.environ["CARTHA_API_KEY"], api_base="https://cartha.in")
client = cartha.wrap_openai()

@cartha.trace(id="support_agent", team="support", budget_usd=0.5)
async def handle(user_id: str, ticket: str) -> str:
    await cartha.remember(user_id=user_id, content=ticket, scope="user")
    hits = await cartha.recall(
        user_id=user_id, context=ticket, scope=["user"], top_k=3
    )
    r = client.chat.completions.create(
        model="gpt-4o-mini",
        messages=[{"role": "user", "content": f"{ticket}\nMemory: {hits}"}],
    )
    return r.choices[0].message.content or ""

import cartha
from langgraph.graph import StateGraph

cartha.init(api_key="cartha_...", api_base="https://cartha.in")
cartha.instrument()

# ... build StateGraph ...
app = graph.compile()
# optional: app = cartha.observe(app)
app.invoke({"input": "hello"})  # run appears under Traces

import cartha
# from crewai import Crew, Agent, Task

cartha.init(api_key="cartha_...", api_base="https://cartha.in")

@cartha.trace(id="research_crew", team="research", budget_usd=1.0)
def run_crew(topic: str):
    # crew = Crew(agents=[...], tasks=[...])
    # return crew.kickoff(inputs={"topic": topic})
    return f"researched {topic}"

run_crew("agent governance")