Metadata-Version: 2.4
Name: maivn-tools
Version: 0.1.0
Summary: Optional tool integrations for the mAIvn Python SDK
Project-URL: Homepage, https://maivn.io
Project-URL: Repository, https://github.com/mAIvn-developer/maivn-tools
Project-URL: Issues, https://github.com/mAIvn-developer/maivn-tools/issues
Project-URL: Changelog, https://github.com/mAIvn-developer/maivn-tools/blob/master/CHANGELOG.md
Author-email: Chad Heathcote <developer@maivn.io>
License-Expression: Apache-2.0
License-File: LICENSE
License-File: NOTICE
Keywords: agents,ai,maivn,sdk,tools
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: maivn<0.5.0,>=0.4.0
Requires-Dist: pydantic>=2.0
Provides-Extra: all
Requires-Dist: psycopg[binary]>=3.1; extra == 'all'
Requires-Dist: pypdf>=4.0; extra == 'all'
Requires-Dist: python-docx>=1.0; extra == 'all'
Provides-Extra: docx
Requires-Dist: python-docx>=1.0; extra == 'docx'
Provides-Extra: html
Provides-Extra: pdf
Requires-Dist: pypdf>=4.0; extra == 'pdf'
Provides-Extra: postgres
Requires-Dist: psycopg[binary]>=3.1; extra == 'postgres'
Description-Content-Type: text/markdown

# mAIvn Tools

Official optional connector layer for the [mAIvn Python SDK](https://github.com/mAIvn-developer/maivn).

> [!warning]
> **Experimental — use with care.** `maivn-tools` is in early development
> (alpha). Connectors and toolsets are exercised against a mock transport in
> CI, but **most have not yet been validated end-to-end against live
> third-party provider APIs**. Request shapes, behavior, and the public surface
> may change between releases. Test against your own provider accounts before
> relying on any connector in production, and please
> [report issues](https://github.com/mAIvn-developer/maivn-tools/issues).

`maivn-tools` is a standalone PyPI package that depends on `maivn`. Installing it
pulls the SDK as well:

```bash
pip install maivn-tools
```

The package is not exposed as a `maivn[tools]` extra. That would create the same
circular release coupling we removed for `maivn[studio]` in 0.3.0; instead,
`maivn-tools` pins a compatible SDK version range directly.

## Development

```powershell
uv sync
uv run pytest
uv run ruff check .
uv run pyright
```

See [`docs/`](docs) for usage guides and [`docs/index.md`](docs/index.md) for the
documentation index.
