Skip to main content

Modular, provider-agnostic AI framework for multi-model orchestration, agent workflows, and vision.

Project description


HoloAI – A modular, provider-agnostic AI framework for multi-model orchestration, agent workflows, and vision."

NOTICE: PLEASE DO NOT INSTALL VERSION 0.1.0 - 0.1.7, 0.2.4 - 0.2.6, and 0.2.9 - 0.3.1 THEY ARE NOT STABLE AND WILL BREAK YOUR PROJECT.


Overview

HoloAI is a production-grade, multi-provider orchestrator for LLM and vision models.
Supports OpenAI, Google Gemini, Groq, Grok, and Anthropic, with automatic provider inference. Built for:

  • Agents & bots
  • Workflow automation
  • Voice assistants
  • Any application needing multi-model, multi-provider intelligence

HoloAI unifies OpenAI, Google Gemini, Groq, Grok, and Anthropic: handling agents, conversation, vision, all from a single interface.


Fixes

  • Fixed response issue when using Anthropics reasoning.

New Features

  • Skills and actions can now be passed as a list with the skills param and will be automatically detected, registered and executed.
  • Tool/Function calling
  • Agent support
  • Manual Provider setup (Overrides automatic provider inference using the .env file and model name)

Up Coming Features


Key Features

  • Universal Provider Support: Instantly switch between OpenAI, Google Gemini, Groq, Grok, and Anthropic—no vendor lock-in.
  • Multimodal Ready: Handles text, image, out of the box.
  • Automatic Provider Inference: Just specify your model; HoloAI selects the right backend.
  • Minimal, Clean API: One interface for all major models—rapid integration.

Why HoloAI?

Most LLM wrappers lock you into a single vendor or force you to juggle multiple APIs and formats. HoloAI delivers:

  • One Framework, any provider.
  • No boilerplate, no rewrites.
  • Plug-and-play for agents, scripts, automations, or apps.

Environment

Set API keys as environment variables:

  • OPENAI_API_KEY
  • ANTHROPIC_API_KEY
  • GOOGLE_API_KEY
  • GROQ_API_KEY

Only providers with keys set will be loaded.


Provider Setup (setProvider Usage)

You can configure your providers directly in code—no .env required (unless you want it).
setProvider is flexible and supports all of the following patterns:

1. Single Provider (String)

client = HoloAI()
client.setProvider('OPENAI_API_KEY=sk-xxxx')

Registers only OpenAI as a provider.


2. Multiple Providers (Tuple of Strings)

client = HoloAI()
client.setProvider((
    'OPENAI_API_KEY=sk-xxxx',
    'ANTHROPIC_API_KEY=claude-xxxx'
))

Registers OpenAI and Anthropic as providers.


3. Multiple Providers (List of Strings)

client = HoloAI()
client.setProvider([
    'OPENAI_API_KEY=sk-xxxx',
    'ANTHROPIC_API_KEY=claude-xxxx',
    'GOOGLE_API_KEY=g-xxxx',
    'GROQ_API_KEY=gsk-xxxx'
])

Registers all four providers (OpenAI, Anthropic, Google, Groq).


  1. No Arguments: Use Environment Variables or .env If you want to load API keys automatically from environment variables or a .env file, you do not need to call setProvider() at all—just instantiate HoloAI:
client = HoloAI()

Any providers with API keys available in your environment will be registered automatically.


Tip: You can mix and match—use direct code for development, .env/env for production, or both. Only providers with keys will be registered and available.


Code Examples

You can find code examples on my GitHub repository.


License

This project is licensed under the Apache License, Version 2.0. Copyright 2025 Tristan McBride Sr.


Acknowledgements

Project by:

  • Tristan McBride Sr.
  • Sybil

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

holoai-0.3.4.tar.gz (19.2 kB view details)

Uploaded Source

Built Distribution

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

holoai-0.3.4-py3-none-any.whl (24.9 kB view details)

Uploaded Python 3

File details

Details for the file holoai-0.3.4.tar.gz.

File metadata

  • Download URL: holoai-0.3.4.tar.gz
  • Upload date:
  • Size: 19.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.12.3

File hashes

Hashes for holoai-0.3.4.tar.gz
Algorithm Hash digest
SHA256 87e7aa63a14914d76d7d330060b847b8a3ea4943c98873ad6a83e8697b10c615
MD5 6750c4c60ef05900b67d6c0498717d93
BLAKE2b-256 0a8253b6af91debae27ba10cdfed27028944b72156a25848b60df6ef39145a11

See more details on using hashes here.

File details

Details for the file holoai-0.3.4-py3-none-any.whl.

File metadata

  • Download URL: holoai-0.3.4-py3-none-any.whl
  • Upload date:
  • Size: 24.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.12.3

File hashes

Hashes for holoai-0.3.4-py3-none-any.whl
Algorithm Hash digest
SHA256 4f430102d3fc9cfd354253d05a4dbae6e25ae2275de162d3c2cb00c866e97987
MD5 cbffbef5f50673c2493c60831f142610
BLAKE2b-256 74ba0b0b3354bb60cd83b91ccaccf365843c5f75788e2e11c8f42d67e5fc60e6

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