Metadata-Version: 2.4
Name: superoptix
Version: 0.1.0b16
Summary: Full Stack Agentic AI Framework
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.1
Requires-Dist: jinja2==3.1.6
Requires-Dist: numpy==2.3.1
Requires-Dist: pyyaml==6.0.2
Requires-Dist: requests==2.32.4
Requires-Dist: rich==14.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: autogen-ext<1.0,>=0.2; extra == 'all'
Requires-Dist: chromadb==1.0.15; extra == 'all'
Requires-Dist: faiss-cpu==1.11.0; extra == 'all'
Requires-Dist: fastapi==0.116.1; 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: optimas-ai==0.0.4; extra == 'all'
Requires-Dist: pandas==2.3.0; extra == 'all'
Requires-Dist: plotly==6.2.0; extra == 'all'
Requires-Dist: pydantic==2.11.7; extra == 'all'
Requires-Dist: pymilvus==2.5.12; extra == 'all'
Requires-Dist: qdrant-client==1.14.3; extra == 'all'
Requires-Dist: redis==6.2.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: autogen-ext<1.0,>=0.2; extra == 'all-with-mlx'
Requires-Dist: chromadb==1.0.15; 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: 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: pandas==2.3.0; extra == 'all-with-mlx'
Requires-Dist: plotly==6.2.0; extra == 'all-with-mlx'
Requires-Dist: pydantic==2.11.7; 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.2.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.0.15; 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: 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: 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: optimas
Requires-Dist: autogen-agentchat<1.0,>=0.2; extra == 'optimas'
Requires-Dist: autogen-ext<1.0,>=0.2; extra == 'optimas'
Requires-Dist: openai<2.0.0,>=1.0.0; extra == 'optimas'
Requires-Dist: optimas-ai==0.0.4; extra == 'optimas'
Provides-Extra: optimas-autogen
Requires-Dist: autogen-agentchat<1.0,>=0.2; extra == 'optimas-autogen'
Requires-Dist: autogen-ext<1.0,>=0.2; extra == 'optimas-autogen'
Provides-Extra: optimas-openai
Requires-Dist: openai<2.0.0,>=1.0.0; extra == 'optimas-openai'
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.2.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.0.15; 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.7; 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 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>
    <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>
    <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 • Orchestration-Ready</strong>
  </p>
</div>

---

## 🎯 Quick Start

```bash
# Install SuperOptiX
pip install superoptix

# Or with uv
uv pip install superoptix

# Install GPT-OSS models (OpenAI's latest open-source models)
super model install gpt-oss:20b   # Advanced reasoning
super model install gpt-oss:120b  # Production-level reasoning

# Follow the steps 
super docs

## ⚠️ Important Note: CrewAI Dependency Conflict

**CrewAI has a known dependency conflict** with SuperOptiX due to incompatible `json-repair` version requirements:

- **DSPy 3.0.0** requires `json-repair>=0.30.0`
- **CrewAI 0.157.0** requires `json-repair==0.25.2`

**To use CrewAI with SuperOptiX, install it manually:**
```bash
# 1. Install SuperOptiX with DSPy support
pip install "superoptix[optimas]"

# 2. Install CrewAI without dependencies
pip install crewai==0.157.0 --no-deps

# 3. Ensure compatible json-repair version
pip install "json-repair>=0.30.0"
```

See our [Installation Guide](docs/setup.md) for more details.
```

## 🤖 GPT-OSS Model Support

SuperOptiX now supports **OpenAI's latest open-source models** with **native Apple Silicon support**:

- **GPT-OSS-20B**: 21B parameters (3.6B active) - Perfect for advanced reasoning
- **GPT-OSS-120B**: 117B parameters (5.1B active) - Production-ready for complex tasks

**🍎 Apple Silicon Support:**
- **MLX-LM v0.26.3**: Native Apple Silicon support with proper MXFP4 quantization
- **Ollama GGUF**: Optimized format for best performance (19.7 t/s)
- **Multiple Backend Options**: Choose between MLX (native) and Ollama (performance)

**Key Features:**
- 🔓 **Apache 2.0 License** - Build freely without restrictions
- ⚡ **Native MXFP4 Quantization** - Optimized for efficient inference
- 🍎 **Apple Silicon Native** - No more mixed precision issues

**Usage:**
```bash
# MLX-LM (native Apple Silicon support)
super model run openai_gpt-oss-20b "prompt" --backend mlx

# Ollama (best performance)
super model run gpt-oss:20b "prompt" --backend ollama
```

**Resources:**
- [GPT-OSS-120B Model](https://huggingface.co/openai/gpt-oss-120b) - HuggingFace repository
- [GPT-OSS-20B Model](https://huggingface.co/openai/gpt-oss-20b) - HuggingFace repository
- [Ollama Library](https://ollama.com/library/gpt-oss) - Ollama model library

---

## 📚 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/) |


---

## 🆘 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>
