Metadata-Version: 2.4
Name: neurovn
Version: 0.1.0
Summary: Neurovn SDK and CLI for tracing agentic AI workflows
Author-email: Neurovn <contact@neurovn.com>
Maintainer-email: Neurovn <contact@neurovn.com>
License-Expression: MIT
Project-URL: Homepage, https://neurovn.com
Project-URL: Documentation, https://neurovn.com/docs
Project-URL: Repository, https://github.com/RajanChavada/Neurovn
Project-URL: Issues, https://github.com/RajanChavada/Neurovn/issues
Keywords: ai,llm,tracing,workflow,agent,observability
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# Neurovn SDK

Python SDK and CLI for tracing agentic AI workflows.

## Installation

The package name is `neurovn`.

```bash
pip install neurovn
```

If you are working from this monorepo before publishing, install it in editable mode:

```bash
cd neurovn-sdk
pip install -e .
```

## Quick Start

### Decorator Integration

```python
from neurovn import trace

@trace.agent(name="Research Agent", model="gpt-4o", provider="OpenAI")
async def research(query: str) -> str:
    return "research results"

@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"):
    result = await research("latest AI updates")
```

### CLI Integration

```bash
python -m neurovn trace ./workflow.json --workflow-name "My Workflow" --source cli
```

## 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
- **Usage Tracking**: Capture token usage from LLM responses

## Documentation

For full integration guides and examples, visit [Neurovn Docs](https://neurovn.com/docs).

## License

MIT
