neurovn 0.1.1

Neurovn SDK and CLI for tracing agentic AI workflows

Neurovn SDK

Python SDK and CLI for tracing agentic AI workflows.

Installation

The package is published on PyPI as neurovn.

python -m venv .venv
source .venv/bin/activate
pip install --upgrade neurovn

Verified release: neurovn==0.1.1.

If you are contributing from this monorepo and need an editable install:

cd neurovn-sdk
pip install -e .

Point the SDK at the hosted Neurovn backend:

export NEUROVN_API_URL=https://agentic-flow.onrender.com

Quick Start

CLI Integration

NEUROVN_API_URL=https://agentic-flow.onrender.com neurovn trace ./workflow.json --workflow-name "My Workflow" --canvas-name "My Workflow" --source cli

Module entrypoint fallback:

NEUROVN_API_URL=https://agentic-flow.onrender.com python -m neurovn trace ./workflow.json --workflow-name "My Workflow" --canvas-name "My Workflow" --source cli

Decorator Integration

from neurovn import trace

@trace.agent(name="Research Agent", model="gpt-4o", provider="OpenAI")
async def research(query: str):
    response = await openai.chat.completions.create(...)
    return response

@trace.tool(name="Web Search", tool_id="mcp_web_search", tool_category="mcp_server")
async def web_search(query: str) -> str:
    return "search results"

with trace.session("My Workflow", source="decorator", canvas_name="My Workflow"):
    result = await research("latest AI updates")

if trace.last_result:
    print(trace.last_result["canvas_id"])

Features

• Trace Decorators: Instrument Python functions with @trace.agent and @trace.tool
• CLI: Emit workflow JSON files to Neurovn backend
• Session Management: Group multiple calls into a workflow session and print a terminal summary for explicit sessions
• Usage Tracking: Capture token usage from LLM responses

Documentation

For full integration guides and examples, visit Neurovn Docs.

Notes

• External users should install from PyPI. The editable install path is contributor-only.
• neurovn trace ... and python -m neurovn trace ... are equivalent entrypoints.
• Local trace persistence depends on the backend being reachable and configured with a valid Supabase service-role key.

License

MIT