Platform capabilities - Evolve

meta() returns the platform’s capability document. It needs no API key. Method reference: calls, parameters, and response fields. Examples reuse the SDK setup. Run Python snippets inside the async function shown in the Python guide.

import { meta } from "@evolvingmachines/evolve";

const capabilities = await meta();
for (const agent of capabilities.agents) {
  console.log(agent.name, agent.runnable, agent.models.map((m) => m.alias));
}

from evolve import meta

capabilities = await meta()
for agent in capabilities.agents:
    print(agent.name, agent.runnable, [m.alias for m in agent.models])

Also available as hosted().meta() in both languages.

What to read

Field	Use it to answer
`agents`	Which harnesses run? Which model names, effort inputs, versions, and presets does the API accept?
`retired_agents`	Which harnesses are retired, and which harness replaces each?
`sandbox_providers`	Which providers support the task’s resources and features?
`platform_constraints`	Which requirements cannot run on this deployment?
`network_modes`	Which network modes can a task declare?
`analyze`	Which agents, models, effort inputs, and configured defaults do analyses and checks accept?
`limits`	What are the current defaults and bounds for jobs, pages, uploads, and comparisons?
`statuses`	Which states exist, and which are terminal?
`agent_registration`	Which names, environment keys, and upload sizes can a custom agent use?
`error_codes`, `import_warning_codes`	Which failure and warning codes does this deployment publish?
`managed_providers`	Which providers are available to the separate managed-agent runtime?

Read capabilities when building a picker or validating a saved configuration. For reasoning options by model, see the model reference.

Configuration

meta(config?) accepts the usual hosted configuration. Only the API origin matters; credentials are not sent. The result includes schema_version. Treat it as the document’s schema version, not the SDK package version. Read the full editable analyzer policy through analysis defaults or check defaults.

Last modified on November 9, 2026