Metadata-Version: 2.4
Name: openstackai
Version: 0.6.1
Summary: The Pandas of AI Agents - Build AI applications in 3 lines or less
Project-URL: Homepage, https://github.com/gitpavleenbali/PYAI
Project-URL: Documentation, https://github.com/gitpavleenbali/PYAI#readme
Project-URL: Repository, https://github.com/gitpavleenbali/PYAI
Project-URL: Issues, https://github.com/gitpavleenbali/PYAI/issues
Project-URL: Changelog, https://github.com/gitpavleenbali/PYAI/blob/master/docs/CHANGELOG.md
Author: OpenStackAI Contributors
Maintainer-email: OpenStackAI Team <openstackai@example.com>
License-Expression: MIT
License-File: LICENSE
Keywords: agents,ai,anthropic,artificial-intelligence,automation,azure,chatbot,easy,langchain,llm,machine-learning,mcp,multi-agent,openai,orchestration,pandas,rag,semantic-kernel,simple
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.9
Requires-Dist: pydantic>=2.0.0
Requires-Dist: pyyaml>=6.0
Provides-Extra: all
Requires-Dist: aiohttp>=3.8.0; extra == 'all'
Requires-Dist: anthropic>=0.18.0; extra == 'all'
Requires-Dist: azure-identity>=1.15.0; extra == 'all'
Requires-Dist: azure-search-documents>=11.4.0; extra == 'all'
Requires-Dist: beautifulsoup4>=4.12.0; extra == 'all'
Requires-Dist: chromadb>=0.4.0; extra == 'all'
Requires-Dist: langchain-community>=0.1.0; extra == 'all'
Requires-Dist: langchain>=0.1.0; extra == 'all'
Requires-Dist: openai>=1.0.0; extra == 'all'
Requires-Dist: pypdf>=3.0.0; extra == 'all'
Requires-Dist: python-docx>=0.8.11; extra == 'all'
Requires-Dist: requests>=2.28.0; extra == 'all'
Requires-Dist: semantic-kernel>=0.5.0; extra == 'all'
Provides-Extra: anthropic
Requires-Dist: anthropic>=0.18.0; extra == 'anthropic'
Provides-Extra: azure
Requires-Dist: azure-identity>=1.15.0; extra == 'azure'
Requires-Dist: azure-search-documents>=11.4.0; extra == 'azure'
Requires-Dist: openai>=1.0.0; extra == 'azure'
Provides-Extra: dev
Requires-Dist: black>=23.0.0; extra == 'dev'
Requires-Dist: mypy>=1.0.0; extra == 'dev'
Requires-Dist: pre-commit>=3.0.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
Requires-Dist: pytest-timeout>=2.2.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: requests>=2.28.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Provides-Extra: docs
Requires-Dist: pypdf>=3.0.0; extra == 'docs'
Requires-Dist: python-docx>=0.8.11; extra == 'docs'
Provides-Extra: langchain
Requires-Dist: langchain-community>=0.1.0; extra == 'langchain'
Requires-Dist: langchain>=0.1.0; extra == 'langchain'
Provides-Extra: openai
Requires-Dist: openai>=1.0.0; extra == 'openai'
Provides-Extra: semantic-kernel
Requires-Dist: semantic-kernel>=0.5.0; extra == 'semantic-kernel'
Provides-Extra: vector
Requires-Dist: chromadb>=0.4.0; extra == 'vector'
Requires-Dist: faiss-cpu>=1.7.0; extra == 'vector'
Requires-Dist: pinecone-client>=3.0.0; extra == 'vector'
Requires-Dist: qdrant-client>=1.7.0; extra == 'vector'
Provides-Extra: web
Requires-Dist: aiohttp>=3.8.0; extra == 'web'
Requires-Dist: beautifulsoup4>=4.12.0; extra == 'web'
Requires-Dist: requests>=2.28.0; extra == 'web'
Description-Content-Type: text/markdown

<p align="center">
  <img src="https://img.shields.io/badge/openstackai-Intelligence%20Engine-blueviolet?style=for-the-badge&logo=python&logoColor=white" alt="openstackai"/>
</p>

<h1 align="center">🧠 openstackai</h1>
<h3 align="center">Three-Dimensional Intelligence Engine</h3>

<p align="center">
  <strong>The Intelligence Engine for Software Factories</strong><br/>
  <em>Build, Orchestrate, and Scale AI-Native Applications</em>
</p>

<p align="center">
  <a href="https://pypi.org/project/openstackai/"><img src="https://img.shields.io/pypi/v/openstackai" alt="PyPI"/></a>
  <a href="https://python.org/"><img src="https://img.shields.io/badge/python-3.10+-green" alt="Python"/></a>
  <a href="https://github.com/gitpavleenbali/PYAI"><img src="https://img.shields.io/badge/tests-671%20passing-brightgreen" alt="Tests"/></a>
  <a href="https://github.com/gitpavleenbali/PYAI/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-yellow" alt="License"/></a>
  <a href="https://gitpavleenbali.github.io/PYAI/"><img src="https://img.shields.io/badge/docs-website-blue" alt="Documentation"/></a>
</p>

---

## 🚀 Quick Start

```bash
pip install openstackai
```

### One-Line AI Operations

```python
from openstackai import ask, summarize, research

# Ask anything
answer = ask("What is machine learning?")

# Summarize documents
summary = summarize("Long document text...")

# Research topics
report = research("Latest AI trends 2026")
```

### Build AI Agents

```python
from openstackai import Agent, Runner

agent = Agent(
    name="Assistant",
    instructions="You are a helpful AI assistant."
)

result = Runner.run_sync(agent, "Hello!")
print(result.final_output)
```

### Multi-Agent Workflows

```python
from openstackai import Agent, Runner
from openstackai.blueprint import ChainWorkflow

researcher = Agent(name="Researcher", instructions="Research topics")
writer = Agent(name="Writer", instructions="Write articles")

workflow = ChainWorkflow([researcher, writer])
result = Runner.run_sync(workflow, "AI in healthcare")
```

---

## ✨ Key Features

| Feature | Description |
|---------|-------------|
| **🎯 Simple APIs** | One-liner functions: `ask()`, `summarize()`, `research()`, `extract()`, `generate()` |
| **🤖 Agent Framework** | Full agent system with `Agent`, `Runner`, memory, and context passing |
| **🔗 Multi-Agent** | Orchestration patterns: Chain, Supervisor, Swarm, Tree of Thoughts |
| **🔌 Multi-Provider** | OpenAI, Azure OpenAI, Anthropic, Ollama, Gemini, Groq |
| **📊 Vector DBs** | ChromaDB, Pinecone, Qdrant, Weaviate integration |
| **🏢 Enterprise** | Azure AD auth, sessions, guardrails, evaluation, tracing |
| **🧩 Extensible** | Custom skills, OpenAPI tools, A2A protocol, plugins |
| **🎙️ Multimodal** | Vision, audio, document understanding |

---

## 🔌 Supported Providers

| Provider | Status | Authentication |
|----------|--------|----------------|
| **OpenAI** | ✅ Full Support | API Key |
| **Azure OpenAI** | ✅ Full Support | API Key / Azure AD |
| **Anthropic Claude** | ✅ Full Support | API Key |
| **Ollama** | ✅ Full Support | Local / Remote |
| **Google Gemini** | ✅ Full Support | API Key |
| **Groq** | ✅ Full Support | API Key |

---

## 📦 Module Overview

| Module | Purpose |
|--------|---------|
| `openstackai.easy` | One-liner AI functions |
| `openstackai.core` | Agent, LLM providers, memory |
| `openstackai.runner` | Agent execution engine |
| `openstackai.blueprint` | Workflows & orchestration patterns |
| `openstackai.skills` | Tools and skills system |
| `openstackai.sessions` | SQLite/Redis session storage |
| `openstackai.vectordb` | Vector database connectors |
| `openstackai.evaluation` | Agent evaluation framework |
| `openstackai.openapi` | OpenAPI tool generation |
| `openstackai.multimodal` | Vision, audio support |
| `openstackai.a2a` | Agent-to-Agent protocol |

---

## 🔧 Configuration

### Environment Variables

```bash
# OpenAI
export OPENAI_API_KEY="sk-..."

# Azure OpenAI
export AZURE_OPENAI_ENDPOINT="https://your-resource.openai.azure.com/"
export AZURE_OPENAI_DEPLOYMENT="gpt-4o-mini"
export AZURE_OPENAI_API_KEY="..."  # Or use Azure AD

# Anthropic
export ANTHROPIC_API_KEY="sk-ant-..."
```

### YAML Agent Configuration

```yaml
# research_agent.yaml
name: "Research Agent"
instructions: "You are an expert researcher."
provider: "openai"
model: "gpt-4o-mini"
skills:
  - web_search
  - summarize
```

```python
from openstackai.config import AgentConfig
agent = AgentConfig.from_yaml("research_agent.yaml").create_agent()
```

---

## 📚 Documentation

- **📖 Full Documentation**: [gitpavleenbali.github.io/PYAI](https://gitpavleenbali.github.io/PYAI/)
- **📘 GitHub Repository**: [github.com/gitpavleenbali/PYAI](https://github.com/gitpavleenbali/PYAI)
- **📋 Changelog**: [Changelog](https://gitpavleenbali.github.io/PYAI/docs/Changelog)
- **🏗️ Architecture**: [Architecture Guide](https://gitpavleenbali.github.io/PYAI/docs/Architecture)

---

## 🤝 Contributing

Contributions are welcome! See our [Contributing Guide](https://github.com/gitpavleenbali/PYAI/blob/master/docs/CONTRIBUTING.md).

---

## 📄 License

MIT License - see [LICENSE](https://github.com/gitpavleenbali/PYAI/blob/master/LICENSE) for details.

---

<p align="center">
  <strong>Built with ❤️ for the AI community</strong><br/>
  <em>openstackai - The Intelligence Engine for Software Factories</em>
</p>
