Initialise

Create agents.yaml configuration file

Set API Key

1. Configure a provider

   Run the interactive setup wizard to pick a provider and save your API key:

   praisonai setup
   

   PraisonAI supports OpenAI, Anthropic, Google/Gemini, Groq, Cohere, Ollama, OpenRouter and 100+ models via LiteLLM. Alternatively, export a key directly:

   export OPENAI_API_KEY="your-key"       # OpenAI
   export ANTHROPIC_API_KEY="your-key"   # Anthropic Claude
   export GEMINI_API_KEY="your-key"      # Google Gemini
   
2. Generate agents.yaml

   python -m praisonai --init "your topic here"
   

   If no provider is configured, --init prints setup guidance and exits instead of crashing. Run praisonai setup (step above) to configure a provider first.

Generate agents.yaml

python -m praisonai --init "your topic here"

Example:

python -m praisonai --init "research AI trends and write a summary"

Output:

File /path/to/agents.yaml created successfully

Generated File

The command creates agents.yaml in the current directory:

framework: praisonai
topic: research AI trends and write a summary
roles:
  researcher:
    backstory: An experienced research analyst...
    goal: Gather relevant information on the topic
    role: Research Analyst
    tasks:
      research_task:
        description: Conduct research on the topic
        expected_output: Key insights and references
    tools:
    - internet_search

Next Step

Run the agents:

python -m praisonai