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, IT IS 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.
New Features
- 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_KEYANTHROPIC_API_KEYGOOGLE_API_KEYGROQ_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).
- 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 MIT. Copyright 2025 Tristan McBride Sr.
Acknowledgments
Project by:
- Tristan McBride Sr.
- Sybil
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file holoai-0.2.6.tar.gz.
File metadata
- Download URL: holoai-0.2.6.tar.gz
- Upload date:
- Size: 17.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.0.1 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b023a9d05661fd4ccc9bc62176630765eed40d2f6760e1bec3dbb75c5cd2715e
|
|
| MD5 |
da8604a0aa97827b9390026b017575b1
|
|
| BLAKE2b-256 |
8d46e1ed948d8ba5e3962128fba2a3c4d33009570b1d7f0577bd7f973fe80329
|
File details
Details for the file holoai-0.2.6-py3-none-any.whl.
File metadata
- Download URL: holoai-0.2.6-py3-none-any.whl
- Upload date:
- Size: 24.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.0.1 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ee3805c64ff1efa6a54c1619233dd44f471d9e002a42f61891b4c13d231b7edd
|
|
| MD5 |
227a12c64ff80339ddcfe0568880ac9a
|
|
| BLAKE2b-256 |
6b9b6441874e0c3727f7dc5e0a974c3b5ffbfe83c6e5b7fe896393f47ffea7d4
|