Metadata-Version: 2.4
Name: HoloAI
Version: 0.2.8
Summary: Modular, provider-agnostic AI framework for multi-model orchestration, agent workflows, and vision.
Author: Tristan McBride Sr.
Author-email: "Tristan McBride Sr." <142635792+TristanMcBrideSr@users.noreply.github.com>
Maintainer-email: "Tristan McBride Sr." <142635792+TristanMcBrideSr@users.noreply.github.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/TristanMcBrideSr
Keywords: AI,AI Client,Agents,Skills,Tools,Learning,Productivity,Automation
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: openai
Requires-Dist: groq
Requires-Dist: google-genai
Requires-Dist: anthropic
Requires-Dist: SyncLink
Requires-Dist: SynMem
Requires-Dist: SynLrn
Requires-Dist: BitSig
Requires-Dist: MediaCapture
Requires-Dist: AgentToAgent
Requires-Dist: python-dotenv
Requires-Dist: requests
Requires-Dist: opencv-python
Requires-Dist: Pillow
Requires-Dist: gguf-parser
Requires-Dist: numpy
Dynamic: author

﻿
---

# 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 and 0.2.4 - 0.2.6, 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.

---

## 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_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)**

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

*Registers only OpenAI as a provider.*

---

### 2. **Multiple Providers (Tuple of Strings)**

```python
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)**

```python
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).*

---

4. 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:

```python
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](https://github.com/TristanMcBrideSr/TechBook).

---

## License

This project is licensed under the [MIT](LICENSE).
Copyright 2025 Tristan McBride Sr.

---

## Acknowledgments

Project by:
- Tristan McBride Sr.
- Sybil
