Skip to main content
The Agent SDK now ships inside the opperai package. The previous standalone agent SDKs no longer get updates. 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 has a migration guide for each language. They cover the breaking changes: imports, constructors, method renames, schema changes, and 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.