Skip to main content

A Python framework for LLM tool calls routing, automation, and orchestration

Project description

Voitta

PyPI version Python Versions Downloads License GitHub Stars

A Python framework for routing, automating, and orchestrating LLM tool calls. Voitta simplifies the integration of AI agents with external tools and APIs, enabling more powerful and flexible AI applications.

Features

  • Tool Call Routing: Seamlessly route LLM tool calls to the appropriate handlers
  • Flexible Configuration: Define your tools and routing logic using YAML or Python
  • Framework Agnostic: Works with any LLM provider or framework
  • Extensible Architecture: Easily add custom tools and integrations
  • Observability: Monitor and debug tool calls with built-in logging

Installation

From PyPI (Stable Release)

pip install voitta

From TestPyPI (Pre-release Versions)

To install the latest pre-release version from TestPyPI:

pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ voitta

The --extra-index-url flag is needed to fetch dependencies from the main PyPI repository, as TestPyPI may not have all the required dependencies.

You can also specify a particular version:

pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ voitta==0.2.3

Note: Pre-release versions on TestPyPI may contain experimental features and bugs. Use in production environments at your own risk.

Quick Start

from voitta import Voitta

# Initialize Voitta
voitta = Voitta()

# Register a tool handler
@voitta.tool("get_weather")
def get_weather(location, unit="celsius"):
    # Implementation to fetch weather data
    return {"temperature": 22, "condition": "sunny", "location": location, "unit": unit}

# Process an LLM tool call
result = voitta.process_tool_call({
    "name": "get_weather",
    "arguments": {"location": "San Francisco", "unit": "fahrenheit"}
})

print(result)  # Output: {"temperature": 72, "condition": "sunny", "location": "San Francisco", "unit": "fahrenheit"}

Usage

For detailed usage examples and documentation, please refer to:

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

voitta-0.14.0.tar.gz (16.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

voitta-0.14.0-py3-none-any.whl (15.8 kB view details)

Uploaded Python 3

File details

Details for the file voitta-0.14.0.tar.gz.

File metadata

  • Download URL: voitta-0.14.0.tar.gz
  • Upload date:
  • Size: 16.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.8

File hashes

Hashes for voitta-0.14.0.tar.gz
Algorithm Hash digest
SHA256 df53fff8dcce215a86b464c01e57a44aabffb6003ffe4aa62be2d6c62f40dcf6
MD5 cf9808fc43b73aef265d59bb3f736409
BLAKE2b-256 13afdb408eb8abe3bd6840a91819e6523ce9d00d64169ca6655174bf78185a5a

See more details on using hashes here.

File details

Details for the file voitta-0.14.0-py3-none-any.whl.

File metadata

  • Download URL: voitta-0.14.0-py3-none-any.whl
  • Upload date:
  • Size: 15.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.8

File hashes

Hashes for voitta-0.14.0-py3-none-any.whl
Algorithm Hash digest
SHA256 20d057b4cd6576630638c7fe6ff3cd57346dff90bff679607790b4b547e4a16e
MD5 3917c5cb051caf4090ccfd8fcd7b066d
BLAKE2b-256 8f30c88c41b5f19cb1a21f84de1e4ac536cfb399b1e0e241c23f4a6926f80fdf

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page