Full Stack Agentic AI Optimization Framework - Universal GEPA optimizer for major frameworks
Project description
SuperOptiX AI
Full Stack Agentic AI Optimization Framework
Evaluation-first workflow, framework-native pipelines, and GEPA optimization.
Quick Install
Recommended CLI install with uv
uv tool install superoptix
super --help
Add framework dependencies in the same tool environment
# OpenAI Agents SDK
uv tool install superoptix --with "superoptix[frameworks-openai]"
# Claude Agent SDK
uv tool install superoptix --with "superoptix[frameworks-claude-sdk]"
# Google ADK
uv tool install superoptix --with "superoptix[frameworks-google]"
# Pydantic AI
uv tool install superoptix --with "superoptix[frameworks-pydantic-ai]"
# DeepAgents
uv tool install superoptix --with "superoptix[frameworks-deepagents]"
# Microsoft Agent Framework (legacy support)
uv tool install superoptix --with "superoptix[frameworks-microsoft]"
# CrewAI (see note below)
uv tool install superoptix --with "superoptix[frameworks-crewai]"
CrewAI and DSPy have dependency constraints that may require separate environments in some setups.
Alternative with pip
pip install superoptix
Requirements: Python 3.11+
Framework Support
SuperOptiX supports compiling and running agents across:
- DSPy
- OpenAI Agents SDK
- Claude Agent SDK
- Pydantic AI
- CrewAI
- Google ADK
- DeepAgents
- Microsoft Agent Framework (legacy support)
Core Workflow
# Pull
super agent pull developer
# Compile minimal pipeline
super agent compile developer --framework dspy
# Run
super agent run developer --framework dspy --goal "Design a migration strategy"
# Optional optimization path
super agent compile developer --framework dspy --optimize
super agent optimize developer --framework dspy --auto light
Featured Capabilities
- RLM support (experimental)
- StackOne connector integrations for SaaS tools
- GEPA optimization flow across frameworks
- Minimal runtime pipelines by default with optional optimization lifecycle
Documentation
- Docs home: https://superagenticai.github.io/superoptix/
- Golden workflow: https://superagenticai.github.io/superoptix/guides/golden-workflow/
- Framework feature matrix: https://superagenticai.github.io/superoptix/guides/framework-feature-matrix/
- StackOne integration: https://superagenticai.github.io/superoptix/guides/stackone-integration/
- RLM (experimental): https://superagenticai.github.io/superoptix/guides/rlm-experimental/
- Troubleshooting by symptom: https://superagenticai.github.io/superoptix/guides/troubleshooting-by-symptom/
SuperOptiX Lite (Companion Repo)
For a lightweight, MIT-licensed starter kit focused on OpenAI Agents SDK + GEPA:
git clone https://github.com/SuperagenticAI/superoptix-lite-openai.git
Support
- Website: https://superoptix.ai
- GitHub: https://github.com/SuperagenticAI/superoptix
- PyPI: https://pypi.org/project/superoptix/
Telemetry
SuperOptiX collects anonymous usage data to improve the tool.
To disable telemetry:
export SUPEROPTIX_TELEMETRY=false
License
Apache License 2.0. See LICENCE.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file superoptix-0.2.14.tar.gz.
File metadata
- Download URL: superoptix-0.2.14.tar.gz
- Upload date:
- Size: 5.4 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b3cc2d4a45b6d1ea53ca9789c5ef3add02062ee6f8997721901f459993a4c239
|
|
| MD5 |
2d36871b09c918aab09da8e08af9e6e4
|
|
| BLAKE2b-256 |
c7fced2d87f67bcceb46dae8ac9759062ff8622f9da362d8633b38b040a36383
|
File details
Details for the file superoptix-0.2.14-py3-none-any.whl.
File metadata
- Download URL: superoptix-0.2.14-py3-none-any.whl
- Upload date:
- Size: 1.3 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fc29bcc50a05bc183e1e31a1f6c55dc8ad2a46e52d1cc4619596a8146628b3d7
|
|
| MD5 |
4ba55bf149b13829b19fd7f9fa872df4
|
|
| BLAKE2b-256 |
7803ccd97f31c49d6b3a7d83937b01fd0d6aedf16f543dccb468f88efeac9754
|