aiagentnotes

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

Development (this monorepo)

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

Publish to PyPI

See ../docs/PUBLISHING.md.