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

Flexible Skills & Actions
You can now provide both skills and actions to the model in two ways:
- Bundled: capabilities=[skills, actions]
- Separate: skills=skills, actions=actions
If only actions is provided (without skills), this will result in an error.
Skills and actions will be executed if the model chooses to call them.
Tool/Function calling
Agent support
Manual Provider setup (Overrides automatic provider inference using the .env file and model name)
Can now pass in files as well as images to the model limited only by the models max context window. (pdf, docx, txt) NOTE: images in pdf and docx files are not supported yet. and will be ignored.
Image generation support (xAI, OpenAI, Google)

Up Coming Features

Support for more file and image types

Key Features

Universal Provider Support: Instantly switch between OpenAI, Google Gemini, Groq, Grok, and Anthropic—no vendor lock-in.
Multimodal Ready: Handles text, vision, generation, 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
GEMINI_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',
    'GEMINI_API_KEY=g-xxxx',
    'GROQ_API_KEY=gsk-xxxx'
])

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

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

Authors

Tristan McBride Sr.
Sybil

Release files for HoloAI 0.5.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for HoloAI 0.5.2
File	Size	Uploaded
holoai-0.5.2.tar.gz	28.2 kB	Aug 30, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for HoloAI 0.5.2
File	Interpreter	ABI	Platform	Reset
holoai-0.5.2-py3-none-any.whl 34.5 kB Aug 30, 2025	Python 3	none	any	Details

Total release size: 62.7 kB

Release files / holoai-0.5.2.tar.gz

Download URL	holoai-0.5.2.tar.gz
Size	28.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`1010c9c88afd4d9408b3d6ad8a02d218ce25037d71926410ec73acbe6b05e565`
BLAKE2b-256 checksum How to use checksums	`7e9aa65a693fb04897588fd1649ef14a0848f4182f15da7806f30915c8b8bb0f`
Upload date	Aug 30, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.0.1 CPython/3.12.3`

Release files / holoai-0.5.2-py3-none-any.whl

Download URL	holoai-0.5.2-py3-none-any.whl
Size	34.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`e85ca6d1607b49485e1221ee1c21682c2c78387a30245c4c184ac721929a8377`
BLAKE2b-256 checksum How to use checksums	`b08e5dc5f9449abbe198de456575fe4f587dcb727e1d07d3fa5b5919f714095f`
Upload date	Aug 30, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.0.1 CPython/3.12.3`