Server: A2A

pip install "praisonai[serve]"
export OPENAI_API_KEY="your-key"

# Start A2A server — runs the workflow in agents.yaml
praisonai serve a2a --file agents.yaml

✓ Starting A2A server on 127.0.0.1:8082
  Agents file: agents.yaml
  Agent Card: /.well-known/agent.json
  Discovery: /__praisonai__/discovery

# Localhost — no key required
praisonai serve a2a

# Remote — key required (via env var)
export PRAISONAI_SERVE_API_KEY="your-secret"
praisonai serve a2a --host 0.0.0.0

# Or via flag
praisonai serve a2a --host 0.0.0.0 --api-key "your-secret"

from praisonaiagents import Agent, A2A

agent = Agent(
    name="Assistant",
    role="Helpful AI Assistant",
    goal="Help users with their questions",
    llm="gpt-4o-mini"
)

a2a = A2A(agent=agent)
a2a.serve(host="0.0.0.0", port=8000)

INFO:     Started server process
INFO:     Waiting for application startup.
INFO:     Application startup complete.
INFO:     Uvicorn running on http://0.0.0.0:8000

curl http://localhost:8000/.well-known/agent.json

{
  "name": "Assistant",
  "description": "Helpful AI Assistant",
  "url": "http://localhost:8000/a2a",
  "version": "1.0.0",
  "capabilities": {
    "streaming": true,
    "pushNotifications": false,
    "stateTransitionHistory": false
  }
}

a2a = A2A(agent=agent, auth_token="sk-my-secret-key")
a2a.serve(port=8000)

curl -X POST http://localhost:8000/a2a \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "message/send",
    "id": "1",
    "params": {
      "message": {
        "role": "user",
        "parts": [{"type": "text", "text": "Hello!"}]
      }
    }
  }'

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": {
    "message": {
      "role": "agent",
      "parts": [{"type": "text", "text": "Hello! How can I help you?"}]
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": "1",
  "error": {"code": -32602, "message": "message/send requires a text part"}
}

import requests

# Get Agent Card
response = requests.get("http://localhost:8000/.well-known/agent.json")
agent_card = response.json()
print(f"Agent: {agent_card['name']}")

# Send Message
message = {
    "jsonrpc": "2.0",
    "method": "message/send",
    "id": "1",
    "params": {
        "message": {
            "role": "user",
            "parts": [{"type": "text", "text": "Hello!"}]
        }
    }
}
response = requests.post("http://localhost:8000/a2a", json=message)
print(response.json())