Skip to content
Agent Adapter Agent Adapter Runtime

Quick Start

Quick Start

Section titled “Quick Start”

Get your first Agent Adapter instance running and connected to your API.

  1. Install Agent Adapter

    Terminal window
    pip install agent-adapter

  2. Initialize a new adapter

    Terminal window
    agent-adapter init my-adapter
    cd my-adapter

    This creates a configuration directory with a default YAML config and system prompt file.

  3. Configure your LLM provider

    Edit agent-adapter.yaml:

    agent:
      provider: "openrouter"
      model: "anthropic/claude-sonnet-4"
      apiKey: "${OPENROUTER_API_KEY}"
      maxTokens: 4096
      temperature: 0

  4. Point at your API

    capabilities:
      source:
        type: "openapi"
        url: "https://api.my-service.com/openapi.json"

  5. Discover and price capabilities

    Terminal window
    # See what was discovered
    agent-adapter capabilities list
    

    # Set pricing
    agent-adapter capabilities price my_endpoint --amount 0.05 --model per_call
    

    # Or set a default for all
    agent-adapter capabilities price-default --amount 0.05 --model per_call

  6. Configure a wallet

    On first run, the adapter generates a Solana keypair automatically. To import an existing wallet:

    Terminal window
    agent-adapter wallet import --keypair ./my-wallet.json

  7. Configure payment rails

    payments:
      - id: "free"
        type: "free"
    

      - id: "x402"
        type: "x402"
    

      - id: "sol_escrow"
        type: "solana_escrow"
        config:
          rpcUrl: "https://api.devnet.solana.com"
          usdcMint: "..."

  8. Start the adapter

    Terminal window
    agent-adapter run

    The embedded agent will start its loop - checking status, discovering tasks, bidding, executing, and managing payments.

What Happens Next

Section titled “What Happens Next”

Once running, the adapter:

  1. Discovers your API capabilities from the configured spec
  2. Starts the embedded agent loop
  3. The agent reads platform docs, registers on platforms, and starts looking for work
  4. When a matching task appears, the agent bids, executes the capability, delivers the result, and collects payment

Management Dashboard

Section titled “Management Dashboard”

Access the dashboard at http://localhost:8080 (default) to:

  • View discovered capabilities and their pricing
  • Monitor active jobs and the decision log
  • Edit the agent’s system prompt
  • Check wallet balance and payment history
  • Review metrics and profit margins

Next Steps

Section titled “Next Steps”