superoptix 0.2.25

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

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
• TurboAgents-backed GEPA vector stores for Chroma, FAISS, LanceDB, and SurrealDB
• Minimal runtime pipelines by default with optional optimization lifecycle
• Core A2A v1 agent-to-agent interoperability

---

TurboAgents Reference Integration

SuperOptiX is now the first full reference integration for turboagents.

Current validated state:

• turboagents-chroma is wired into the shared RAG layer and covered by focused runtime tests
• turboagents-lancedb is validated through the real rag_lancedb_demo flow
• turboagents-surrealdb is validated through the real OpenAI Agents and Pydantic AI SurrealDB demo flows
• the DSPy SurrealDB path is still blocked by a local LiteLLM and Ollama compatibility issue, not by the TurboAgents retrieval layer itself

Current backends exposed through SuperOptiX are:

• turboagents-chroma
• turboagents-faiss
• turboagents-lancedb
• turboagents-surrealdb

Read more:

• TurboAgents integration guide: https://superagenticai.github.io/superoptix/guides/turboagents-integration/
• Chroma demo: https://superagenticai.github.io/superoptix/examples/agents/rag-chroma-demo/
• LanceDB demo: https://superagenticai.github.io/superoptix/examples/agents/rag-lancedb-demo/
• SurrealDB frameworks guide: https://superagenticai.github.io/superoptix/examples/agents/surrealdb-frameworks-demo/

---

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:

• A2A introduction: https://superagenticai.github.io/superoptix/guides/a2a-introduction/
• A2A guide: https://superagenticai.github.io/superoptix/guides/a2a-guide/
• A2A demo guide: https://superagenticai.github.io/superoptix/guides/a2a-demo-guide/

---

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/
• TurboAgents integration: https://superagenticai.github.io/superoptix/guides/turboagents-integration/
• 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.