Quickstart

pip install provenlog
plog run -- python my_agent.py

import provenlog.auto  # Add this line before framework imports

from langchain_core.chat_models import ChatOpenAI
# ... your agent code

from provenlog import ProvenLogClient

# Embedded mode — writes to local SQLite, no server needed
client = ProvenLogClient(agent_id="my-agent")

client.log_event(
    action_type="TOOL_CALL",
    action_name="search_database",
    action_input={"query": "revenue Q4"},
    action_status="success",
    action_output={"results": 42}
)

client.close()

npm install provenlog

import { ProvenLogClient } from "provenlog";

const client = new ProvenLogClient("http://localhost:7600", {
  agentId: "my-agent",
});

client.logEvent({
  action_type: "TOOL_CALL",
  action_name: "fetch_data",
  action_status: "success",
});

await client.close();

# Start the server
plog serve

# Open http://localhost:7600 for the dashboard

# Connect your Python SDK to the server
client = ProvenLogClient("http://localhost:7600", agent_id="my-agent")

# View recent events
plog log --last 10

# Verify hash chain integrity
plog verify --agent-id my-agent