Quick Reference

pip install artanis

from artanis import Artanis
artanis = Artanis(api_key="sk_...")  # or ARTANIS_API_KEY env var

trace = artanis.trace("operation-name")
trace.input(question=q, context=ctx)
trace.output(response)

trace = artanis.trace("rag-answer")

# Retrieve
chunks = retriever.search(query)
trace.state("chunks", [c.id for c in chunks])

# Generate
trace.input(prompt=prompt, model="gpt-5.1")
response = llm.generate(prompt)
trace.output(response)

artanis.feedback(
    trace_id="trace_abc123",
    rating="negative",              # or "positive" or 0.0-1.0
    correction={"answer": "..."},   # optional
    comment="User's note",          # optional
)

# Document corpus
trace.state("documents", [doc.id for doc in corpus])

# Retrieved chunks
trace.state("retrieved_chunks", [
    {"id": c.id, "score": c.score} for c in chunks
])

# Config that affects behavior
trace.state("config", {
    "model": "gpt-5.1",
    "guidelines": guidelines_text,
    "strictness": 0.8,
})

# Safe even if Artanis is down
trace.output(response)  # Never throws

# Recommended
ARTANIS_ENABLED=false pytest
ARTANIS_ENABLED=false npm test