Awesome

Praison AI

<a href="https://trendshift.io/repositories/9130" target="_blank"><img src="https://trendshift.io/api/badge/repositories/9130" alt="MervinPraison%2FPraisonAI | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>

Praison AI, leveraging both AutoGen and CrewAI or any other agent framework, represents a low-code, centralised framework designed to simplify the creation and orchestration of multi-agent systems for various LLM applications, emphasizing ease of use, customization, and human-agent interaction.

Different User Interfaces:

Google Colab Multi Agents

Installation Options

Using pip

pip install praisonai

Framework-specific Installation

# Install with CrewAI support
pip install "praisonai[crewai]"

# Install with AutoGen support
pip install "praisonai[autogen]"

# Install with both frameworks
pip install "praisonai[crewai,autogen]"

UI and Additional Features

# Install UI support
pip install "praisonai[ui]"

# Install Chat interface
pip install "praisonai[chat]"

# Install Code interface
pip install "praisonai[code]"

# Install Realtime voice interaction
pip install "praisonai[realtime]"

# Install Call feature
pip install "praisonai[call]"

Quick Start

# Set your OpenAI API key
export OPENAI_API_KEY="Enter your API key"

# Initialize with CrewAI (default)
praisonai --init "create a movie script about dog in moon"

# Or initialize with AutoGen
praisonai --framework autogen --init "create a movie script about dog in moon"

# Run the agents
praisonai

Full Automatic Mode

# With CrewAI (default)
praisonai --auto "create a movie script about Dog in Moon"

# With AutoGen
praisonai --framework autogen --auto "create a movie script about Dog in Moon"

Framework-specific Features

CrewAI

When installing with pip install "praisonai[crewai]", you get:

• CrewAI framework support
• PraisonAI tools integration
• Task delegation capabilities
• Sequential and parallel task execution

AutoGen

When installing with pip install "praisonai[autogen]", you get:

• AutoGen framework support
• PraisonAI tools integration
• Multi-agent conversation capabilities
• Code execution environment

Key Features

• 🤖 Automated AI Agents Creation
• 🔄 Use CrewAI or AutoGen Framework
• 💯 100+ LLM Support
• 💻 Chat with ENTIRE Codebase
• 🖥️ Interactive UIs
• 📄 YAML-based Configuration
• 🛠️ Custom Tool Integration
• 🔍 Internet Search Capability (using Crawl4AI and Tavily)
• 👁️ Vision Language Model (VLM) Support
• 🎙️ Real-time Voice Interaction

TL;DR Multi Agents

pip install praisonai
export OPENAI_API_KEY="Enter your API key"
praisonai --init create a movie script about dog in moon
praisonai

Table of Contents

• Installation
• Initialise
• Run
• Full Automatic Mode
• User Interface
• Praison AI Chat
• Create Custom Tools
• Agents Playbook
• Include praisonai package in your project
• Commands to Install Dev Dependencies
• Other Models
• Contributing
• Star History

Installation Multi Agents

pip install praisonai

Initialise

export OPENAI_API_KEY="Enter your API key"

Generate your OPENAI API KEY from here: https://platform.openai.com/api-keys

Note: You can use other providers such as Ollama, Mistral ... etc. Details are provided at the bottom.

praisonai --init create a movie script about dog in moon

This will automatically create agents.yaml file in the current directory.

To initialise with a specific agent framework (Optional):

praisonai --framework autogen --init create movie script about cat in mars

Run

praisonai

or

python -m praisonai

Specify the agent framework (Optional):

praisonai --framework autogen

Full Automatic Mode

praisonai --auto create a movie script about Dog in Moon

User Interface

PraisonAI User Interfaces:

pip install -U "praisonai[ui]"
export OPENAI_API_KEY="Enter your API key"
chainlit create-secret
export CHAINLIT_AUTH_SECRET=xxxxxxxx
praisonai ui

or

python -m praisonai ui

Praison AI Chat

• https://docs.praison.ai/chat/

pip install "praisonai[chat]"
export OPENAI_API_KEY="Enter your API key"
praisonai chat

Internet Search

Praison AI Chat and Praison AI Code now includes internet search capabilities using Crawl4AI and Tavily, allowing you to retrieve up-to-date information during your conversations.

Vision Language Model Support

You can now upload images and ask questions based on them using Vision Language Models. This feature enables visual understanding and analysis within your chat sessions.

Praison AI Code

pip install "praisonai[code]"
export OPENAI_API_KEY="Enter your API key"
praisonai code

Internet Search

Praison AI Code also includes internet search functionality, enabling you to find relevant code snippets and programming information online.

Create Custom Tools

• https://docs.praison.ai/tools/custom/

Agents Playbook

Simple Playbook Example

framework: crewai
topic: Artificial Intelligence
roles:
  screenwriter:
    backstory: "Skilled in crafting scripts with engaging dialogue about {topic}."
    goal: Create scripts from concepts.
    role: Screenwriter
    tasks:
      scriptwriting_task:
        description: "Develop scripts with compelling characters and dialogue about {topic}."
        expected_output: "Complete script ready for production."

Use 100+ Models

• https://docs.praison.ai/models/

Include praisonai package in your project

• https://docs.praison.ai/developers/wrapper
• https://docs.praison.ai/developers/wrapper-tools/

Option 1: Using RAW YAML

from praisonai import PraisonAI

# Example agent_yaml content
agent_yaml = """
framework: "crewai"
topic: "Space Exploration"

roles:
  astronomer:
    role: "Space Researcher"
    goal: "Discover new insights about {topic}"
    backstory: "You are a curious and dedicated astronomer with a passion for unraveling the mysteries of the cosmos."
    tasks:
      investigate_exoplanets:
        description: "Research and compile information about exoplanets discovered in the last decade."
        expected_output: "A summarized report on exoplanet discoveries, including their size, potential habitability, and distance from Earth."
"""

# Create a PraisonAI instance with the agent_yaml content
praisonai = PraisonAI(agent_yaml=agent_yaml)

# Run PraisonAI
result = praisonai.run()

# Print the result
print(result)

Option 2: Using separate agents.yaml file

Note: Please create agents.yaml file before hand.

from praisonai import PraisonAI

def basic(): # Basic Mode
    praisonai = PraisonAI(agent_file="agents.yaml")
    praisonai.run()

if __name__ == "__main__":
    basic()

Commands to Install Dependencies:

1. Install all dependencies, including dev dependencies:

   poetry install
   

2. Install only documentation dependencies:

   poetry install --with docs
   

3. Install only test dependencies:

   poetry install --with test
   

4. Install only dev dependencies:

   poetry install --with dev
   

This configuration ensures that your development dependencies are correctly categorized and installed as needed.

Using uv (Fast Python Package Installer)

# Install uv if you haven't already
pip install uv

# Install from requirements
uv pip install -r pyproject.toml

# Install with extras
uv pip install -r pyproject.toml --extra code
uv pip install -r pyproject.toml --extra "crewai,autogen"

Contributing

• Fork on GitHub: Use the "Fork" button on the repository page.
• Clone your fork: git clone https://github.com/yourusername/praisonAI.git
• Create a branch: git checkout -b new-feature
• Make changes and commit: git commit -am "Add some feature"
• Push to your fork: git push origin new-feature
• Submit a pull request via GitHub's web interface.
• Await feedback from project maintainers.

Star History

License

Praison AI is an open-sourced software licensed under the MIT license.

Video Tutorials

Topic	Video
Introduction
Tools Overview
Custom Tools
Firecrawl Integration
User Interface
Crawl4AI Integration
Chat Interface
Code Interface
Mem0 Integration
Training
Realtime Voice Interface
Call Interface

License

Praison AI is an open-sourced software licensed under the MIT license.