Metadata-Version: 2.4
Name: superoptix
Version: 0.1.8
Summary: Full Stack Agentic AI Optimization Framework - Universal GEPA optimizer for 6 major frameworks
Project-URL: Homepage, https://superoptix.ai
Project-URL: Documentation, https://superagenticai.github.io/superoptix-ai
Project-URL: Repository, https://github.com/SuperagenticAI/superoptix-ai
Project-URL: Bug Tracker, https://github.com/SuperagenticAI/superoptix-ai/issues
Project-URL: Support, https://superoptix.ai
Project-URL: Download, https://pypi.org/project/superoptix/#files
Author-email: Superagentic AI <hello@super-agentic.ai>, Shashi Jagtap <shashikant.jagtap@icloud.com>, Shashi Jagtap <shashi@super-agentic.ai>
Maintainer-email: Superagentic AI <hello@super-agentic.ai>
License: Proprietary License
        
        Copyright (c) 2024 Superagentic AI. All rights reserved.
        
        This software and associated documentation files (the "Software") are the proprietary 
        and confidential information of Superagentic AI. The Software is licensed, not sold.
        
        Permission is hereby granted to use the Software for AI agent development and 
        orchestration, subject to the following conditions:
        
        1. The Software may only be used in accordance with the SuperOptiX License Agreement
        2. No redistribution, modification, or reverse engineering of the Software is permitted
        3. The Software may not be used to create competing products or services
        4. All copies must include this copyright notice and license terms
        5. The Software may be used for commercial and non-commercial purposes within your organization
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
        For licensing inquiries, contact: licensing@super-agentic.ai
License-File: LICENCE
Keywords: agent-development,agent-framework,agent-memory,agent-observability,agent-orchestration,agent-testing,agents,ai,ai-agents,ai-development,ai-memory,ai-observability,ai-testing,artificial-intelligence,autonomous,bdd,context-engineering,dspy,dspy-ai,evaluation,framework,llm,llm-framework,llm-optimization,machine-learning,memory,multi-agent,observability,optimization,orchestration,prompt-engineering,prompt-optimization,rag,semantic-search,superspec,testing,vector-database
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
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: Topic :: System :: Distributed Computing
Requires-Python: >=3.11
Requires-Dist: accelerate
Requires-Dist: colorama==0.4.6
Requires-Dist: dspy==3.0.3
Requires-Dist: jinja2==3.1.6
Requires-Dist: litellm<2.0.0,>=1.0.0
Requires-Dist: mcp==1.19.0
Requires-Dist: numpy==2.3.1
Requires-Dist: pydantic>=2.11.9
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: pyyaml==6.0.2
Requires-Dist: requests==2.32.4
Requires-Dist: rich==14.0.0
Requires-Dist: supabase<3.0.0,>=2.0.0
Requires-Dist: torch>=2.7.1
Requires-Dist: transformers>=4.46.1
Requires-Dist: typer==0.9.0
Provides-Extra: all
Requires-Dist: agent-framework; extra == 'all'
Requires-Dist: azure-identity>=1.15.0; extra == 'all'
Requires-Dist: chromadb<1.2,>=1.1.0; extra == 'all'
Requires-Dist: deepagents>=0.2.0; extra == 'all'
Requires-Dist: dspy==3.0.3; extra == 'all'
Requires-Dist: faiss-cpu==1.11.0; extra == 'all'
Requires-Dist: fastapi==0.116.1; extra == 'all'
Requires-Dist: google-adk==1.17.0; extra == 'all'
Requires-Dist: google-generativeai>=0.8.0; extra == 'all'
Requires-Dist: huggingface-hub>=0.34.0; extra == 'all'
Requires-Dist: lancedb==0.24.0; extra == 'all'
Requires-Dist: langfuse>=2.0.0; extra == 'all'
Requires-Dist: mlflow==3.1.1; extra == 'all'
Requires-Dist: openai-agents==0.4.1; extra == 'all'
Requires-Dist: openai<3,>=2.2; extra == 'all'
Requires-Dist: pandas==2.3.0; extra == 'all'
Requires-Dist: plotly==6.2.0; extra == 'all'
Requires-Dist: pydantic>=2.11.9; extra == 'all'
Requires-Dist: pymilvus==2.5.12; extra == 'all'
Requires-Dist: qdrant-client==1.14.3; extra == 'all'
Requires-Dist: redis>=6.4.0; extra == 'all'
Requires-Dist: sentence-transformers==5.0.0; extra == 'all'
Requires-Dist: streamlit==1.46.1; extra == 'all'
Requires-Dist: torch>=2.7.1; extra == 'all'
Requires-Dist: transformers>=4.46.1; extra == 'all'
Requires-Dist: uvicorn==0.35.0; extra == 'all'
Requires-Dist: weaviate-client==4.15.4; extra == 'all'
Provides-Extra: all-with-mlx
Requires-Dist: agent-framework; extra == 'all-with-mlx'
Requires-Dist: azure-identity>=1.15.0; extra == 'all-with-mlx'
Requires-Dist: chromadb<1.2,>=1.1.0; extra == 'all-with-mlx'
Requires-Dist: deepagents>=0.2.0; extra == 'all-with-mlx'
Requires-Dist: dspy==3.0.3; extra == 'all-with-mlx'
Requires-Dist: faiss-cpu==1.11.0; extra == 'all-with-mlx'
Requires-Dist: fastapi==0.116.1; extra == 'all-with-mlx'
Requires-Dist: google-adk==1.17.0; extra == 'all-with-mlx'
Requires-Dist: google-generativeai>=0.8.0; extra == 'all-with-mlx'
Requires-Dist: huggingface-hub>=0.34.0; extra == 'all-with-mlx'
Requires-Dist: lancedb==0.24.0; extra == 'all-with-mlx'
Requires-Dist: langfuse>=2.0.0; extra == 'all-with-mlx'
Requires-Dist: mlflow==3.1.1; extra == 'all-with-mlx'
Requires-Dist: mlx-lm==0.26.3; extra == 'all-with-mlx'
Requires-Dist: openai-agents==0.4.1; extra == 'all-with-mlx'
Requires-Dist: openai<3,>=2.2; extra == 'all-with-mlx'
Requires-Dist: pandas==2.3.0; extra == 'all-with-mlx'
Requires-Dist: plotly==6.2.0; extra == 'all-with-mlx'
Requires-Dist: pydantic>=2.11.9; extra == 'all-with-mlx'
Requires-Dist: pymilvus==2.5.12; extra == 'all-with-mlx'
Requires-Dist: qdrant-client==1.14.3; extra == 'all-with-mlx'
Requires-Dist: redis>=6.4.0; extra == 'all-with-mlx'
Requires-Dist: sentence-transformers==5.0.0; extra == 'all-with-mlx'
Requires-Dist: streamlit==1.46.1; extra == 'all-with-mlx'
Requires-Dist: torch>=2.7.1; extra == 'all-with-mlx'
Requires-Dist: transformers>=4.46.1; extra == 'all-with-mlx'
Requires-Dist: uvicorn==0.35.0; extra == 'all-with-mlx'
Requires-Dist: weaviate-client==4.15.4; extra == 'all-with-mlx'
Provides-Extra: chromadb
Requires-Dist: chromadb<1.2,>=1.1.0; extra == 'chromadb'
Requires-Dist: sentence-transformers==5.0.0; extra == 'chromadb'
Provides-Extra: cloud
Provides-Extra: data
Provides-Extra: dev
Requires-Dist: black; extra == 'dev'
Requires-Dist: mypy; extra == 'dev'
Requires-Dist: pre-commit; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: pytest-asyncio; extra == 'dev'
Requires-Dist: pytest-cov; extra == 'dev'
Requires-Dist: ruff==0.11.1; extra == 'dev'
Provides-Extra: docs
Requires-Dist: mkdocs-material==9.6.15; extra == 'docs'
Requires-Dist: mkdocs-mermaid2-plugin>=0.6.0; extra == 'docs'
Requires-Dist: mkdocs==1.6.1; extra == 'docs'
Requires-Dist: pymdown-extensions==10.16; extra == 'docs'
Provides-Extra: faiss
Requires-Dist: faiss-cpu==1.11.0; extra == 'faiss'
Requires-Dist: sentence-transformers==5.0.0; extra == 'faiss'
Provides-Extra: frameworks
Requires-Dist: agent-framework; extra == 'frameworks'
Requires-Dist: azure-identity>=1.15.0; extra == 'frameworks'
Requires-Dist: deepagents>=0.2.0; extra == 'frameworks'
Requires-Dist: dspy==3.0.3; extra == 'frameworks'
Requires-Dist: google-adk==1.17.0; extra == 'frameworks'
Requires-Dist: google-generativeai>=0.8.0; extra == 'frameworks'
Requires-Dist: openai-agents==0.4.1; extra == 'frameworks'
Requires-Dist: openai<3,>=2.2; extra == 'frameworks'
Provides-Extra: frameworks-deepagents
Requires-Dist: deepagents>=0.2.0; extra == 'frameworks-deepagents'
Provides-Extra: frameworks-dspy
Requires-Dist: dspy==3.0.3; extra == 'frameworks-dspy'
Provides-Extra: frameworks-google
Requires-Dist: google-adk==1.17.0; extra == 'frameworks-google'
Requires-Dist: google-generativeai>=0.8.0; extra == 'frameworks-google'
Provides-Extra: frameworks-microsoft
Requires-Dist: agent-framework; extra == 'frameworks-microsoft'
Requires-Dist: azure-identity>=1.15.0; extra == 'frameworks-microsoft'
Provides-Extra: frameworks-openai
Requires-Dist: openai-agents==0.4.1; extra == 'frameworks-openai'
Requires-Dist: openai<3,>=2.2; extra == 'frameworks-openai'
Provides-Extra: huggingface
Requires-Dist: fastapi==0.116.1; extra == 'huggingface'
Requires-Dist: huggingface-hub>=0.34.0; extra == 'huggingface'
Requires-Dist: torch>=2.7.1; extra == 'huggingface'
Requires-Dist: transformers>=4.46.1; extra == 'huggingface'
Requires-Dist: uvicorn==0.35.0; extra == 'huggingface'
Provides-Extra: lancedb
Requires-Dist: lancedb==0.24.0; extra == 'lancedb'
Requires-Dist: sentence-transformers==5.0.0; extra == 'lancedb'
Provides-Extra: mcp
Requires-Dist: mcp==1.19.0; extra == 'mcp'
Provides-Extra: milvus
Requires-Dist: pymilvus==2.5.12; extra == 'milvus'
Requires-Dist: sentence-transformers==5.0.0; extra == 'milvus'
Provides-Extra: ml-cross-platform
Requires-Dist: huggingface-hub>=0.34.0; extra == 'ml-cross-platform'
Requires-Dist: torch>=2.7.1; extra == 'ml-cross-platform'
Requires-Dist: transformers>=4.46.1; extra == 'ml-cross-platform'
Provides-Extra: mlx
Requires-Dist: mlx-lm==0.26.3; extra == 'mlx'
Provides-Extra: observability
Requires-Dist: langfuse>=2.0.0; extra == 'observability'
Requires-Dist: mlflow==3.1.1; extra == 'observability'
Requires-Dist: pandas==2.3.0; extra == 'observability'
Requires-Dist: plotly==6.2.0; extra == 'observability'
Provides-Extra: qdrant
Requires-Dist: qdrant-client==1.14.3; extra == 'qdrant'
Requires-Dist: sentence-transformers==5.0.0; extra == 'qdrant'
Provides-Extra: redis
Requires-Dist: redis>=6.4.0; extra == 'redis'
Provides-Extra: testing
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'testing'
Requires-Dist: pytest-cov>=4.0.0; extra == 'testing'
Requires-Dist: pytest-mock>=3.10.0; extra == 'testing'
Requires-Dist: pytest>=7.0.0; extra == 'testing'
Requires-Dist: responses>=0.23.0; extra == 'testing'
Provides-Extra: ui
Requires-Dist: pandas==2.3.0; extra == 'ui'
Requires-Dist: plotly==6.2.0; extra == 'ui'
Requires-Dist: streamlit==1.46.1; extra == 'ui'
Provides-Extra: vectordb
Requires-Dist: chromadb<1.2,>=1.1.0; extra == 'vectordb'
Requires-Dist: faiss-cpu==1.11.0; extra == 'vectordb'
Requires-Dist: lancedb==0.24.0; extra == 'vectordb'
Requires-Dist: pymilvus==2.5.12; extra == 'vectordb'
Requires-Dist: qdrant-client==1.14.3; extra == 'vectordb'
Requires-Dist: sentence-transformers==5.0.0; extra == 'vectordb'
Requires-Dist: weaviate-client==4.15.4; extra == 'vectordb'
Provides-Extra: weaviate
Requires-Dist: sentence-transformers==5.0.0; extra == 'weaviate'
Requires-Dist: weaviate-client==4.15.4; extra == 'weaviate'
Provides-Extra: web
Requires-Dist: fastapi==0.116.1; extra == 'web'
Requires-Dist: pydantic>=2.11.9; extra == 'web'
Requires-Dist: uvicorn==0.35.0; extra == 'web'
Description-Content-Type: text/markdown

<div align="center">
  <h1>🚀 SuperOptiX AI</h1>
  
  <h3><strong>Full Stack Agentic AI Optimization Framework</strong></h3>
  
  <div style="margin: 20px 0;">
    <a href="https://badge.fury.io/py/superoptix">
      <img src="https://badge.fury.io/py/superoptix.svg" alt="PyPI version" />
    </a>
    <img src="https://img.shields.io/badge/version-0.1.3b3-orange.svg" alt="Version 0.1.3b3" />
    <img src="https://img.shields.io/badge/status-beta-yellow.svg" alt="Beta Release" />
    <a href="LICENCE">
      <img src="https://img.shields.io/badge/License-Proprietary-red.svg" alt="License: Proprietary" />
    </a>
    <a href="https://www.python.org/downloads/">
      <img src="https://img.shields.io/badge/python-3.11+-blue.svg" alt="Python 3.11+" />
    </a>
    <img src="https://img.shields.io/badge/frameworks-6-purple.svg" alt="6 Frameworks" />
    <a href="https://superoptix.ai">
      <img src="https://img.shields.io/badge/Website-superoptix.ai-blue.svg" alt="Website" />
    </a>
    <a href="https://github.com/SuperagenticAI/superoptix-ai">
      <img src="https://img.shields.io/badge/GitHub-SuperOptiX-green.svg" alt="GitHub" />
    </a>
  </div>
  
  <p style="font-size: 1.2em; color: #666; margin: 20px 0;">
    <strong>Evaluation-First • Optimization-Core • Multi-Framework • Orchestration-Ready</strong>
  </p>
  
  <p style="font-size: 1.0em; margin: 10px 0;">
    Universal GEPA optimizer for 6 major AI agent frameworks
  </p>
</div>

---

## 🎯 Quick Install

### Simple Install (Recommended)
```bash
pip install superoptix
```

**✅ Includes by Default:**
- **DSPy** - GEPA optimization engine
- **MCP Client** - Model Context Protocol for tool usage
- **Super CLI** - Conversational AI-powered CLI
- **LiteLLM** - Multi-provider LLM inference
- **All Core Features** - Ready to use out of the box!

**Requirements:** Python 3.11+

---

### Additional Frameworks (Optional)

```bash
# OpenAI Agents SDK
pip install superoptix[frameworks-openai]

# Google ADK
pip install superoptix[frameworks-google]

# Microsoft Agent Framework
pip install superoptix[frameworks-microsoft]

# DeepAgents
pip install superoptix[frameworks-deepagents]

# All frameworks (except CrewAI)
pip install superoptix[all]
```

### CrewAI (Separate Install)
```bash
# CrewAI conflicts with DSPy - install separately
pip install superoptix
pip install crewai==1.2.0
```

---

### With MCP Optimization
```bash
pip install superoptix[mcp]
```

**Full guide:** [docs/setup.md](https://superagenticai.github.io/superoptix-ai/setup/)

---


## 📚 Learn More

| Resource | Description | Link |
|----------|-------------|------|
| 🌐 **Website** | Learn about our vision and solutions | [superoptix.ai](https://superoptix.ai) |
| 📖 **GitHub** | Source code and project repository | [@SuperagenticAI/superoptix-ai](https://github.com/SuperagenticAI/superoptix-ai) |
| 📦 **PyPI** | Install via pip | [superoptix](https://pypi.org/project/superoptix/) |
| 🎯 **GEPA Demo** | Interactive GEPA optimization demonstrations | [@SuperagenticAI/gepa-eval](https://github.com/SuperagenticAI/gepa-eval) |


---

## 🆘 Support

<div align="center" style="margin: 20px 0;">
  <a href="https://superoptix.ai" style="text-decoration: none; margin: 0 10px;">
    <img src="https://img.shields.io/badge/Website-superoptix.ai-blue.svg" alt="Website" />
  </a>
  <a href="https://github.com/SuperagenticAI/superoptix-ai" style="text-decoration: none; margin: 0 10px;">
    <img src="https://img.shields.io/badge/GitHub-SuperOptiX-green.svg" alt="GitHub" />
  </a>
  <a href="https://pypi.org/project/superoptix/" style="text-decoration: none; margin: 0 10px;">
    <img src="https://img.shields.io/badge/PyPI-superoptix-orange.svg" alt="PyPI" />
  </a>
</div>

---

## 📄 License

This project is licensed under a proprietary license. For licensing inquiries, contact [licensing@super-agentic.ai](mailto:licensing@super-agentic.ai).

---

<div align="center" style="margin: 40px 0; padding: 20px; background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); color: white; border-radius: 10px;">
  <h2>🚀 Ready to Build the Future?</h2>
  <p style="font-size: 1.1em; margin: 10px 0;">
    <strong>Start with SuperOptiX • Read the Docs • Join the Revolution</strong>
  </p>
  <p style="margin: 10px 0;">
    <em>Powered by DSPy. Refined by Superagentic AI.</em>
  </p>
</div>
