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.19.0.tar.gz (16.7 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.19.0-py3-none-any.whl (15.9 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for voitta-0.19.0.tar.gz
Algorithm Hash digest
SHA256 c163d9037468e801f2d737078e91fe292227fdab1602d77164c34b9214933d09
MD5 d669dae585e6bcec8433f45573d818e4
BLAKE2b-256 abe5725c8163019ba5ba07aa6a298331c486328e6d2419a47fa3a7daaaaf51bc

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for voitta-0.19.0-py3-none-any.whl
Algorithm Hash digest
SHA256 49b99fa3b11ffc082357f019097bab92dcc3b4c916d054d54555630f918a0bbd
MD5 6fe416fdaeb573c43ff2805c7204f405
BLAKE2b-256 a06f255eacff6b494ca6a337b464375928c2ef7ebf6bae335bbad5d8b6ccec87

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