Skip to main content
The Agent SDK now ships inside the unified opperai package. The previous standalone agent SDKs are no longer being developed — but they’re still installable, and we keep links to the old repos here for anyone on those versions.

​
Are you on a legacy version?

LanguageLegacy packageLast legacy versionNew package
Pythonopper-agents<= 0.4.0opperai >= 2.0
TypeScript@opperai/agents<= 0.8.0opperai >= 4.0
If you’re on a version at or below those, you’re on the legacy SDK.

​
Migration guides

The new repo ships a per-language migration guide that covers every breaking change (imports, constructors, method renames, schema changes, MCP config):

Python migration guide

opperai 1.x + opper-agents 0.x → opperai 2.0

TypeScript migration guide

opperai 3.x + @opperai/agents 0.x → opperai 4.0
The headline changes:
  • from opper_agents import ... → from opperai.agent import ... (Python) / from '@opperai/agents' → from 'opperai' (TS)
  • agent.process(...) → agent.run(...); result is { output, meta }
  • description= → instructions= on the Agent constructor
  • Hooks is now a typed object (Python Hooks(...), TS Hooks interface), not individual @hook decorators

​
Legacy repos (read-only)

These repositories are kept up for reference. New work happens in opper-ai/opper-sdks.
PythonTypeScript
Repoopperai-agent-sdkopperai-agent-sdk-node
Packageopper-agents@opperai/agents
If you’re starting a new project, install opperai and follow the Quickstart. If you’re maintaining a project that pins opper-agents or @opperai/agents, the legacy packages still work — but new features land only in opperai.