praisonaiagents

library1.6.63pypypi✓ verified 82d ago

Praison AI Agents is a Python framework for building and orchestrating multi-agent systems with self-reflection capabilities. It supports various AI models (OpenAI, Anthropic, Ollama, etc.) and provides tools for complex task decomposition, agent collaboration, and iterative refinement. The current version is 1.6.33, with a release cadence of multiple updates per month.

llm-agents ai-ml workflow

pip install praisonaiagents

package ↗homepage ↗

INSTALL

IMPORT

SIG · PRAISONAIAGENTS

praisonaiagents

llm-agentspythonv1.6.63

Install

10.0s avg

Import

—

Disk

88MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.6.63 · 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 0.000s · 91.4MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 10.0s · import 0.000s · 93MB

88MB installed

● package 88MB

Code

Verified usage

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

Agent

✓ from praisonaiagents import Agent

✗ from praisonaiagents import PraisonAIAgents

Task

✓ from praisonaiagents import Task

Workflow

✓ from praisonaiagents import Workflow

Basic setup: create an agent, a task, and run the orchestration.

import os from praisonaiagents import PraisonAIAgents from praisonaiagents.agent import Agent from praisonaiagents.task import Task api_key = os.environ.get('OPENAI_API_KEY', '') agent = Agent( name="ResearchAgent", llm="gpt-4", system_prompt="You are a helpful research assistant." ) task = Task( description="Summarize the latest AI trends", agent=agent ) agents = PraisonAIAgents( agents=[agent], tasks=[task], llm=api_key ) result = agents.start() print(result)

praisonai --version

Debug

Known issues

breakingVersion 1.0.0 moved the Agent and Task classes into submodules. Direct imports from the top-level package (e.g., `from praisonaiagents import Agent`) will fail.

fix

Use `from praisonaiagents.agent import Agent` and `from praisonaiagents.task import Task`.

affects: >=1.0.0

breakingThe `PraisonAIAgents` class no longer accepts `llm` as a positional argument; it must be passed as a keyword argument.

fix

Use `PraisonAIAgents(agents=[...], tasks=[...], llm=api_key)` instead of positional.

affects: >=1.5.0

gotchaThe `llm` parameter in `PraisonAIAgents` expects an API key string or a config object, not a model name. Passing a model name directly will cause authentication errors.

fix

Ensure you pass `os.environ.get('OPENAI_API_KEY')` or a properly configured `LLMConfig` object.

affects: all

gotchaBy default, agents use 'openai/gpt-4' model. If you do not set an API key, the agent will fail silently or raise ambiguous errors.

fix

Set the `OPENAI_API_KEY` environment variable or pass an `llm` parameter to `PraisonAIAgents`.

affects: all

deprecatedThe `PraisonAIAgents.initialize()` method is deprecated in favor of `start()`.

fix

Use `agents.start()` instead of `agents.initialize()`.

affects: >=1.6.0

Upgrade

Version history

1.6.63latest on PyPI · released Jun 18, 2026

Audit

Dependencies

openaioptionalDefault LLM provider for agents

anthropicoptionalAlternative LLM provider

Agent activity

40 hits · last 30 days

node

OpenAI (training)

Resources

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

homepagehttps://www.praison.ai ↗