Skip to content

SuperagenticAI/superoptix

SuperOptiX Logo

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
  • Core A2A v1 agent-to-agent interoperability

A2A v1 Support

SuperOptiX implements the core A2A 1.0 protocol shape.

That includes:

  • v1 Agent Cards with supportedInterfaces[]
  • v1 task and message semantics
  • v1 method surface such as SendMessage, GetTask, CancelTask, and SubscribeToTask
  • serving compiled agents over A2A with super agent serve <name> --protocol a2a
  • calling remote A2A agents through the SuperOptiX A2A client
  • packaged A2A demos for DSPy, Pydantic AI, and Google ADK

Install the optional A2A extra:

pip install "superoptix[a2a]"

For the full packaged demo set:

pip install "superoptix[a2a,frameworks-pydantic-ai,frameworks-google]"

For demo details:

  • DSPy demo: no model API key required
  • Pydantic AI demo: no model API key required
  • Google ADK demo: requires GOOGLE_API_KEY

Read more:


Documentation


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


Telemetry

SuperOptiX collects anonymous usage data to improve the tool.

To disable telemetry:

export SUPEROPTIX_TELEMETRY=false

License

Apache License 2.0. See LICENCE.