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

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for voitta-0.24.0.tar.gz
Algorithm Hash digest
SHA256 ea6b72ea51a9a73a112bfaec4818182a00c62ca35c4a30408633f87e0d71be6e
MD5 7d7349cd0c6d58fbed8bb059772c498f
BLAKE2b-256 ecda5fc60d3d5e722065dd5c3ec7b1d9b74d4b604926052ef25b174baf04ba75

See more details on using hashes here.

File details

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

File metadata

  • Download URL: voitta-0.24.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.12.8

File hashes

Hashes for voitta-0.24.0-py3-none-any.whl
Algorithm Hash digest
SHA256 fa5437f5fc57375daf627ba054b1608be557e0beeca259e3b646fef888837748
MD5 71eddd526daadde2070e64c210464ce7
BLAKE2b-256 15dea0b769d42ec432fca058446052f2882c369a1ab98df7ac73fdc3f338570b

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