agenta

library0.104.0pypypi✓ verified 83d ago

Agenta is an open-source LLMOps platform for prompt engineering, evaluation, and deployment. The `agenta` Python SDK (v0.96.10) integrates with your LLM applications to manage prompts, track variants, run evaluations, and collect observability data. Requires Python >=3.11, <4.0. Active development with frequent releases.

llm-agents ai-ml observability devops

pip install agenta

github ↗package ↗homepage ↗docs ↗

INSTALL

IMPORT

SIG · AGENTA

agenta

llm-agentspythonv0.104.0

Install

21.3s avg

Import

11892ms

Disk

242MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.59.12 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 12.382s · 189.2MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 21.3s · import 11.402s · 173MB

242MB installed

● package 242MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

agenta

✓ import agenta

Initialize the SDK and call a prompt from a deployed variant.

import agenta import os # Initialize with API key (set AGENTA_API_KEY environment variable) agenta.init( api_key=os.environ.get("AGENTA_API_KEY", ""), host="http://localhost:3000" # Default self-hosted URL ) # Simple prompt call (requires a deployed variant in the Agenta platform) from agenta import prompt response = prompt.call( app_slug="my-app", variant="default", inputs={"topic": "AI"} ) print(response)

agenta --version

Debug

Known issues

breakingIn v0.96.0 the REST API endpoints changed significantly. The old `/configs/fetch` endpoint was replaced by a new unified invoke API. If you were using the HTTP API directly, update your requests.

fix

Migrate to the new invoke API: use POST /api/v1/apps/{app_id}/variants/{variant_id}/invoke with {'inputs': ...}. See migration guide at https://docs.agenta.ai.

affects: >=0.96.0

breakingThe SDK version 0.96.0 dropped support for Python <3.11. Ensure your environment uses Python 3.11 or later.

fix

Upgrade Python to 3.11+ or pin agenta <0.96.0 if you must use an older Python.

affects: >=0.96.0

breaking`ag.init()` (or `agenta.init()`) must be called before any tracing or prompt calls. In older versions, tracing could work without init; now it raises a warning (v0.96.3) and may fail in future versions.

fix

Always call `agenta.init(api_key=..., host=...)` at the start of your application.

affects: >=0.96.3

deprecatedThe `variant/configs/fetch` legacy adapter was re-added in v0.96.2 as a backward-compatibility bridge, but will be removed in a future release. Use the new invoke API instead.

fix

Replace any calls to `/variant/configs/fetch` with the new unified invoke endpoint.

affects: >=0.96.0

gotchaEnvironment variable `AGENTA_API_KEY` must be set before calling `agenta.init()`. If not set, the SDK may fail silently or raise an unclear error.

fix

Set the environment variable in your shell or pass `api_key` explicitly: `agenta.init(api_key='...')`.

affects: all

Errors

Common errors & fixes

ImportError: cannot import name 'prompt' from 'agenta'

The `prompt` submodule is not directly importable in older SDK versions or if the SDK version is <0.96.0.

fix

Upgrade to agenta >=0.96.0 and use `from agenta import prompt`. If using an older version, use `from agenta.sdk import prompt` or check the docs.

agenta.exceptions.AgentaAPIError: 404 Not Found: The requested variant does not exist.

The app_slug or variant name is incorrect, or the variant has not been deployed in the Agenta platform.

fix

Verify the app_slug and variant name in the Agenta UI. Ensure the variant is deployed (status 'deployed'). Check the host URL.

RuntimeError: You must call agenta.init() before using this feature.

Tracing or prompt calls were attempted before initializing the SDK.

fix

Add `agenta.init(api_key=..., host=...)` at the beginning of your code, before any other agenta calls.

AttributeError: module 'agenta' has no attribute 'init'

An older version of agenta (<0.96.0) uses a different initialization pattern (e.g., `agenta.init_app()` or `agenta.sdk.init()`).

fix

Upgrade to agenta >=0.96.0 with `pip install agenta --upgrade`. For older versions, check the docs for the correct init method.

Upgrade

Version history

0.104.0latest on PyPI · released Jun 18, 2026

Audit

Dependencies

openaioptionalCommonly used together for LLM calls, but optional if using other providers.

Agent activity

57 hits · last 30 days

node

Perplexity

OpenAI (training)

Resources

githubhttps://github.com/agenta-ai/agenta ↗

packagehttps://pypi.org/project/agenta/ ↗

homepagehttps://agenta.ai ↗

docshttps://agenta.ai/docs/ ↗