Skip to main content

Full Stack Agentic AI Optimization Framework - Universal GEPA optimizer for major frameworks

Project description

🚀 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

superoptix-0.2.4.tar.gz (3.9 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

superoptix-0.2.4-py3-none-any.whl (1.4 MB view details)

Uploaded Python 3

File details

Details for the file superoptix-0.2.4.tar.gz.

File metadata

  • Download URL: superoptix-0.2.4.tar.gz
  • Upload date:
  • Size: 3.9 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.7

File hashes

Hashes for superoptix-0.2.4.tar.gz
Algorithm Hash digest
SHA256 8f6650d5fc09b317de04d693d6d20ab027fa1d7a3fba4e1d51fc5bbc2d0643e1
MD5 b0323fc477e080ffa2063161c93649e5
BLAKE2b-256 7fcf64b93fbfca060b809291b867b6c01fcc698f25e60ed47504137cf4c48844

See more details on using hashes here.

File details

Details for the file superoptix-0.2.4-py3-none-any.whl.

File metadata

  • Download URL: superoptix-0.2.4-py3-none-any.whl
  • Upload date:
  • Size: 1.4 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.7

File hashes

Hashes for superoptix-0.2.4-py3-none-any.whl
Algorithm Hash digest
SHA256 aaddfa8b1ab0e2073823f8cda07a3a570d90ba50135f9fc0af4178d3771518c0
MD5 509f49bb8cd0a0a20b9e2775b0cb42bf
BLAKE2b-256 fcc286fb252f3d0d430e07f406f9e4f65975c70525e56193b92724cff374121f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page