maivn-tools 0.1.1

Optional tool integrations for the mAIvn Python SDK

mAIvn Tools

Official optional connector layer for the mAIvn Python SDK.

[!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.

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

pip install maivn-tools

Some connectors need optional dependencies:

pip install "maivn-tools[pdf]"      # pypdf — PDF tooling
pip install "maivn-tools[docx]"     # python-docx — Word docs
pip install "maivn-tools[postgres]" # psycopg — Postgres connector
pip install "maivn-tools[all]"      # everything above

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.

Ecosystem

maivn-tools is the optional connector layer in the mAIvn developer ecosystem. Learn more at maivn.io — or dive into the developer hub at developer.maivn.io.

flowchart TD
    platform["mAIvn platform<br/>hosted agent API"]
    sdk["maivn<br/>Python SDK — agents · tools · swarms"]
    shared["maivn-shared<br/>shared contracts & models"]
    tools["maivn-tools<br/>optional connector toolsets"]
    studio["maivn-studio<br/>local studio — run & debug demos"]

    sdk -->|HTTPS + API key| platform
    sdk -->|depends on| shared
    tools -->|add_toolset| sdk
    studio -->|maivn studio CLI| sdk

    classDef current fill:#dbeafe,stroke:#2563eb,stroke-width:2px;
    class tools current;

Development

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

See docs/ for usage guides and docs/index.md for the documentation index.