Getting Started with OSSA

What is OSSA?

OSSA (Open Standard for Software Agents) is a specification standard for AI agents, similar to how OpenAPI standardizes REST APIs.

OSSA is NOT a framework - it's a standard that defines the contract.

Installation

npm install -g @bluefly/openstandardagents

Quick Start

1. Initialize a New Agent

ossa init my-agent --type worker
cd .agents/my-agent

2. Edit Agent Manifest

Edit agent.yml:

apiVersion: ossa/v{{version}}

agent:
  id: my-agent
  name: My Agent
  version: "1.0.0"
  role: worker
  
  runtime:
    type: docker
    
  capabilities:
    - name: process_data
      description: Process incoming data
      input_schema:
        type: object
        properties:
          data:
            type: string
      output_schema:
        type: object
        properties:
          result:
            type: string

3. Validate

ossa validate agent.yml

4. Deploy

OSSA doesn't dictate deployment. Deploy to YOUR infrastructure:

• Docker / Kubernetes
• AWS / GCP / Azure
• On-premise
• Serverless

CLI Commands

• ossa init <name> - Initialize new agent project
• ossa validate <path> - Validate against OSSA 1.0 schema
• ossa generate <type> - Generate from template
• ossa migrate <source> - Migrate v0.1.9 → 1.0

Next Steps

• Review Examples
• Read the Schema Reference
• Visit the GitHub Repository

Need More Features?

For production features like GitLab integration, Kubernetes deployment, and monitoring, see:

agent-buildkit - Reference implementation with production tooling