🚀 SuperOptiX AI

Full Stack Agentic AI Optimization Framework

Evaluation-First • Optimization-Core • Multi-Framework • Orchestration-Ready

Universal GEPA optimizer for 6 major AI agent frameworks

---

🎯 Quick Install

Simple Install (Recommended)

pip install superoptix

Install as a CLI Tool (uv)

uv tool install superoptix
super --help

✅ 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)

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

# CrewAI conflicts with DSPy - install separately
pip install superoptix
pip install crewai==1.2.0

---

With MCP Optimization

pip install superoptix[mcp]

Full guide: docs/setup.md

---

🪶 SuperOptiX Lite (Open Source Companion)

Looking for a lightweight, MIT-licensed starter kit? Clone the companion repository that powers our OpenAI Agents SDK + GEPA tutorial:

git clone https://github.com/SuperagenticAI/superoptix-lite-openai.git

Included

• ✅ Minimal superoptix_lite BaseComponent scaffolding to expose GEPA-compatible variables
• ✅ Native OpenAI Agents SDK integration tuned for Ollama (Code Reviewer pipeline + tests)
• ✅ Baseline, optimization, and regression scripts that mirror the docs walkthrough

Unlock More with Full SuperOptiX

• 🔓 Universal GEPA optimizer with multi-framework compilers (DSPy, CrewAI*, Google ADK, Microsoft, DeepAgents)
• 🔓 RAG, memory, and SuperNetiX orchestration optimizers
• 🔓 super CLI workflows, observability hooks, and enterprise guardrails

*CrewAI installs separately due to DSPy dependency differences—see install notes above.

When you're ready to graduate from Lite to full production, install the expanded stack:

pip install "superoptix[frameworks-openai]"

Bring the optimized prompts, playbooks, and pipelines you prototype in Lite straight into SuperOptiX for end-to-end automation.

---

📚 Learn More

Resource	Description	Link
🌐 Website	Learn about our vision and solutions	superoptix.ai
📖 GitHub	Source code and project repository	@SuperagenticAI/superoptix-ai
🪶 SuperOptiX Lite	Open source OpenAI SDK + GEPA demo	@SuperagenticAI/superoptix-lite-openai
📦 PyPI	Install via pip	superoptix
🎯 GEPA Demo	Interactive GEPA optimization demonstrations	@SuperagenticAI/gepa-eval

---

🆘 Support

---

📊 Telemetry

SuperOptiX collects anonymous usage data to help us understand how the tool is used and improve it. This data is anonymous and does not include any sensitive information like API keys, prompt content, or environment variables.

To disable telemetry, set the environment variable:

export SUPEROPTIX_TELEMETRY=false

📄 License

This project is licensed under the Apache License, Version 2.0. See the LICENCE file for details.

---

🚀 Ready to Build the Future?

Start with SuperOptiX • Read the Docs • Join the Revolution

Powered by DSPy. Refined by Superagentic AI.