Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.opper.ai/llms.txt

Use this file to discover all available pages before exploring further.

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.