aiagentnotes 0.1.0

SparkNotes for your AI agents — log runs to AgentNotes with one pip install and env vars.

AgentNotes Python SDK

SparkNotes for your AI agents. Install once, set env vars, call AgentNotes.from_env().

Install (PyPI)

pip install aiagentnotes

Optional local .env support:

pip install "aiagentnotes[dotenv]"

Environment variables

See ENV.md for the full list.

Minimum:

export AGENTNOTES_API_KEY="an_xxxxxxxx"
export AGENTNOTES_AGENT_ID="my-bot-slug"
export AGENTNOTES_BASE_URL="https://your-agentnotes.vercel.app"

Quick start

from aiagentnotes import AgentNotes

notes = AgentNotes.from_env()

@notes.track("handle_request")
def handle_request(req):
    notes.log("received", data={"id": getattr(req, "id", None)})
    notes.complete_run({"summary": "Done"})

Optional: logging only when configured

from aiagentnotes import get_client

notes = get_client()
if notes:
    notes.log("bot started")

API

Method	Description
AgentNotes.from_env()	Build client from AGENTNOTES_* env vars
get_client()	Same, or None if not configured
require_client()	Same, or raise with setup instructions
notes.log(message, ...)	Log an event
notes.complete_run(result)	Finish run
notes.track("step")	Decorator for a step

Development (this monorepo)

cd sdk && pip install -e ".[dev,dotenv]"

Publish to PyPI

See ../docs/PUBLISHING.md.