# Install
pip install praisonai praisonai-tools

# Run the tool
praisonai recipe run ai-api-doc-generator \
  --input '{"input": "your-input-here"}' \
  --json

# With output directory
praisonai recipe run ai-api-doc-generator \
  --input-file config.json \
  --out-dir ./output

{
  "ok": true,
  "run_id": "run_abc123",
  "recipe": "ai-api-doc-generator",
  "output": {},
  "artifacts": [],
  "warnings": [],
  "error": null
}

from praisonai.recipes import run_recipe

# Basic usage
result = run_recipe(
    "ai-api-doc-generator",
    input={
        "input": "your-input-here"
    }
)

print(f"Success: {result['ok']}")
print(f"Output: {result['output']}")

# With streaming (if supported)
for event in run_recipe("ai-api-doc-generator", input={}, stream=True):
    print(event)

praisonai recipe serve --port 8080

curl -X POST http://localhost:8080/v1/recipes/run \
  -H "Content-Type: application/json" \
  -d '{
    "recipe": "ai-api-doc-generator",
    "input": {"input": "your-input-here"}
  }'

export PRAISONAI_ENDPOINTS_URL=https://api.praisonai.com
export PRAISONAI_ENDPOINTS_API_KEY=your-key

curl -X POST $PRAISONAI_ENDPOINTS_URL/v1/recipes/run \
  -H "X-API-Key: $PRAISONAI_ENDPOINTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"recipe": "ai-api-doc-generator", "input": {}}'

{
  "type": "object",
  "properties": {
    "input": {"type": "string", "description": "Primary input"},
    "options": {"type": "object", "description": "Additional options"}
  },
  "required": ["input"]
}

{
  "ok": true,
  "run_id": "string",
  "recipe": "ai-api-doc-generator",
  "output": {},
  "artifacts": [{"path": "string", "type": "string"}],
  "warnings": [],
  "error": null
}

from praisonai.recipes import run_recipe
result = run_recipe("ai-api-doc-generator", input={"input": "data"})

praisonai recipe run ai-api-doc-generator --input-file config.json --json

praisonai recipe serve --port 8080
curl -X POST http://localhost:8080/v1/recipes/run -d '...'

import os
os.environ["PRAISONAI_ENDPOINTS_URL"] = "https://api.praisonai.com"
os.environ["PRAISONAI_ENDPOINTS_API_KEY"] = "your-key"

queue.publish("recipes.run", {
    "recipe": "ai-api-doc-generator",
    "input": {},
    "callback_url": "https://your-app.com/webhook"
})

from praisonaiagents import Agent
agent = Agent(name="Worker", tools=["ai-api-doc-generator"])

pip install praisonai-tools
# Requires: LLM