{"id":24261,"library":"praisonaiagents","title":"Praison AI Agents","description":"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.","status":"active","version":"1.6.33","language":"python","source_language":"en","source_url":"https://github.com/praison-ai/praisonai-agents","tags":["agents","multi-agent","llm","orchestration","ai","self-reflection"],"install":[{"cmd":"pip install praisonaiagents","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Default LLM provider for agents","package":"openai","optional":true},{"reason":"Alternative LLM provider","package":"anthropic","optional":true}],"imports":[{"note":"The package was previously named 'praisonai' and the import path changed.","wrong":"from praisonai import PraisonAIAgents","symbol":"PraisonAIAgents","correct":"from praisonaiagents import PraisonAIAgents"},{"note":"Agent class was moved to submodule.","wrong":"from praisonai import Agent","symbol":"Agent","correct":"from praisonaiagents.agent import Agent"},{"note":"Always import from the correct submodule to avoid deprecation warnings.","wrong":null,"symbol":"Task","correct":"from praisonaiagents.task import Task"}],"quickstart":{"code":"import os\nfrom praisonaiagents import PraisonAIAgents\nfrom praisonaiagents.agent import Agent\nfrom praisonaiagents.task import Task\n\napi_key = os.environ.get('OPENAI_API_KEY', '')\n\nagent = Agent(\n    name=\"ResearchAgent\",\n    llm=\"gpt-4\",\n    system_prompt=\"You are a helpful research assistant.\"\n)\n\ntask = Task(\n    description=\"Summarize the latest AI trends\",\n    agent=agent\n)\n\nagents = PraisonAIAgents(\n    agents=[agent],\n    tasks=[task],\n    llm=api_key\n)\n\nresult = agents.start()\nprint(result)","lang":"python","description":"Basic setup: create an agent, a task, and run the orchestration."},"warnings":[{"fix":"Use `from praisonaiagents.agent import Agent` and `from praisonaiagents.task import Task`.","message":"Version 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.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Use `PraisonAIAgents(agents=[...], tasks=[...], llm=api_key)` instead of positional.","message":"The `PraisonAIAgents` class no longer accepts `llm` as a positional argument; it must be passed as a keyword argument.","severity":"breaking","affected_versions":">=1.5.0"},{"fix":"Ensure you pass `os.environ.get('OPENAI_API_KEY')` or a properly configured `LLMConfig` object.","message":"The `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.","severity":"gotcha","affected_versions":"all"},{"fix":"Set the `OPENAI_API_KEY` environment variable or pass an `llm` parameter to `PraisonAIAgents`.","message":"By default, agents use 'openai/gpt-4' model. If you do not set an API key, the agent will fail silently or raise ambiguous errors.","severity":"gotcha","affected_versions":"all"},{"fix":"Use `agents.start()` instead of `agents.initialize()`.","message":"The `PraisonAIAgents.initialize()` method is deprecated in favor of `start()`.","severity":"deprecated","affected_versions":">=1.6.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run `pip install praisonaiagents` (note the 'agents' suffix).","cause":"Typo or incorrect package name (e.g., 'praisonai' instead of 'praisonaiagents').","error":"ModuleNotFoundError: No module named 'praisonaiagents'"},{"fix":"Use `from praisonaiagents.agent import Agent`.","cause":"Old import path; Agent class was moved to submodule.","error":"ImportError: cannot import name 'Agent' from 'praisonaiagents'"},{"fix":"Pass `llm=os.environ.get('OPENAI_API_KEY')` as a keyword argument.","cause":"Passing arguments to PraisonAIAgents without keyword, or missing required config.","error":"TypeError: __init__() missing 1 required positional argument: 'llm'"},{"fix":"Set `export OPENAI_API_KEY='your-key'` or pass a different API key via `llm`.","cause":"Environment variable not set but required by default LLM provider.","error":"KeyError: 'OPENAI_API_KEY'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}