Skip to main content

A Python package that provides an easier user interface for multiple LLM providers.

Project description

azllm: A Unified LLM Interface for Multi-Provider Access

PyPI version DOI Python Downloads

azllm is a Python package that provides a unified interface to work with multiple LLM providers including OpenAI, DeepSeek, Grok, Gemini, Meta's LLaMA, Anthropic, Ollama, and more.

NOTE: For advanced usage, see the azllm documentation and/or examples.


Features

  • One unified interface for all major LLM APIs
  • Batch and parallel prompt generation
  • Structured outputs (parsing) with Pydantic
  • Per-model configurations and lazy initialization
  • Clean error handling
  • .env-based API key management

Supported Clients

NOTE: If you would like to request support for additional LLMs, please open an issue on our GitHub page.

Installation

You can install the azllm package via pip:

pip install azllm

Prerequisites

  • Python 3.11+

  • Create a .env file to store your API keys. For example:

    OPENAI_API_KEY=your_openai_api_key
    DEEPSEEK_API_KEY=your_deepseek_api_key
    XAI_API_KEY=your_xai_api_key
    GEMINI_API_KEY=your_gemini_api_key
    ANTHROPIC_API_KEY=your_anthropic_api_key
    FIREWORKS_API_KEY=your_fireworks_api_key
    
  • Ollama must be installed and running locally to use Ollama models.

Quick Start

Basic Initialization

from azllm import azLLM
manager = azLLM()  # Instantiated with default parameters 

Generate Text from a Single Prompt

prompt = 'What is the captial of France?'
generated_text = manager.generate_text('openai', prompt)
print(generated_text)

Batch Generation

Generate responses for multiple prompts at once:

batch_prompts = [
    'What is the capital of France?',
    'Tell me a joke.'
    ]

results = manager.batch_generate('openai', batch_prompts)
for result in results:
    print(result)

Parallel Generation

Run a single prompt across multiple models simultaneously:

prompt = 'What is the capital of France?'
models = [
    'openai',
    'grok',
    'ollama']

results = manager.generate_parallel(prompt, models)
for model, result in results.items():
    print(f"Model: {model},\nResult: {result}\n")

License

MIT License

Citation

@misc{azLLM,
  title        = {azllm},
  author       = {Hanif Sajid and Benjamin Radford and Yaoyao Dai and Jason Windett},
  year         = {2025},
  month        = apr,
  version      = {0.1.2},
  howpublished = {https://github.com/hanifsajid/azllm},
  note         = {MIT License},
  abstract     = {azllm is a Python package designed to interface with various large language models (LLMs) from different AI providers. It offers a unified interface for interacting with models from providers like OpenAI, DeepSeek, Grok, Gemini, Meta's Llama, Anthropic, Ollama, and others. The package allows for customizable configurations, batch generation, parallel generation, error handling, and the ability to parse structured responses from different models.}
}

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

azllm-0.1.2.tar.gz (14.4 kB view details)

Uploaded Source

Built Distribution

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

azllm-0.1.2-py3-none-any.whl (26.4 kB view details)

Uploaded Python 3

File details

Details for the file azllm-0.1.2.tar.gz.

File metadata

  • Download URL: azllm-0.1.2.tar.gz
  • Upload date:
  • Size: 14.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.1.2 CPython/3.13.2 Darwin/24.3.0

File hashes

Hashes for azllm-0.1.2.tar.gz
Algorithm Hash digest
SHA256 d7be823f5bbd486f5d3403eda398e51848ea304f321fd3d4f4f1f44a878073f9
MD5 cc62c0da62c94da4c427d811b3f96944
BLAKE2b-256 49006a20940147501d744b4eaa820ec8e339ac578b7f40453beefeee10bb383d

See more details on using hashes here.

File details

Details for the file azllm-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: azllm-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 26.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.1.2 CPython/3.13.2 Darwin/24.3.0

File hashes

Hashes for azllm-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 cece1b727630b4ef6cb6489b272d25c741e6e1bb282226f2549acdaba926986f
MD5 5903735f61274c9b30bd3e1320834c42
BLAKE2b-256 119cb3d8f4c921b7c536fcb8e38127484b821ac58fee15167d95b30d98c8e736

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