Quickstart

pip install nexus-library[langchain]

pip install nexus-library[openai]

from nexus_library.nexus_core import NexusClient

nexus_key = "your_nexus_api_key"
client = NexusClient(api_key=nexus_key)

with client.span("root-workflow", event_type="chain", input_data={"question": "What is Nexus?"}) as root:
    with client.span("lookup-tool", event_type="tool", input_data={"query": "nexus-library"}) as tool_span:
        tool_span.set_output({"result": "Tracing library for AI systems"})

    root.set_output({"status": "ok"})

client.flush()

from nexus_library.nexus_core import NexusClient
from nexus_library.langchain import LangHandler

nexus_key = "your_nexus_api_key"
nexus_client = NexusClient(api_key=nexus_key)
callback_handler = LangHandler(nexus_client)

# Attach `callback_handler` to your LangChain runnable / agent callbacks

import asyncio
import os
from agents import Agent, Runner, set_trace_processors
from nexus_library.nexus_core import NexusClient
from nexus_library.openai import NexusOpenAITracingProcessor

nexus_client = NexusClient(api_key=os.environ["NEXUS_API_KEY"])
dev_mode = os.getenv("NEXUS_DEV_MODE", "false").lower() == "true"
tracing_processor = NexusOpenAITracingProcessor(nexus_client, dev_mode=dev_mode)

set_trace_processors([tracing_processor])

async def main():
    agent = Agent(name="my-agent", instructions="You are a helpful assistant.")
    result = await Runner.run(agent, "Hello!")
    print(result.final_output)

asyncio.run(main())