Skip to main content

​
Prerequisites

  • Connector built and tested (see Build a Connector)
  • All certification gates passed
  • Ed25519 keypair for package signing
  • Marketplace author account

​
Package Format

Marketplace packages are .argent-pkg files (gzipped tarballs): 
aos-{name}.argent-pkg (tar.gz)
├── argent.plugin.json          <- Package manifest
├── connector.json              <- Connector metadata
├── agent-harness/              <- Python CLI harness
├── README.md                   <- Documentation
├── SIGNATURE                   <- Ed25519 signature
└── SHA256SUMS                  <- Checksums

​
Step 1: Create Package Manifest

Create argent.plugin.json in your connector directory: 
{
  "name": "aos-{name}",
  "version": "1.0.0",
  "description": "AOS connector for {Vendor} — {what it does}",
  "author": {
    "name": "Your Name",
    "publicKey": "<Ed25519 public key base64>"
  },
  "category": "connectors",
  "tags": ["vendor-name", "category-tag"],
  "license": "MIT",
  "pricing": "free",
  "price_cents": 0,
  "compatibility": {
    "argentos": ">=2026.3.0"
  },
  "permissions": ["network"]
}

​
Pricing Options

TypeDurationUse Case
freeUnlimitedOpen source, no license required
trial7-30 daysTime-limited evaluation
pro1 year, 3 activationsStandard paid license
enterprise1 year, unlimited activationsMulti-instance deployment
per-skillPerpetual, 1 activationOne-time purchase
Revenue split for paid connectors: 70% creator / 30% ArgentOS. Payouts via Stripe Connect.

​
Step 2: Build the Tarball

cd tools/aos/aos-{name}

tar -czf aos-{name}.argent-pkg \
  argent.plugin.json \
  connector.json \
  agent-harness/ \
  README.md

​
Step 3: Generate Checksums

sha256sum aos-{name}.argent-pkg > SHA256SUMS

​
Step 4: Sign the Package

Sign with your Ed25519 private key: 
# Sign the SHA256 hash
# Add SIGNATURE and SHA256SUMS to the package:
tar -czf aos-{name}.argent-pkg \
  argent.plugin.json \
  connector.json \
  agent-harness/ \
  README.md \
  SHA256SUMS \
  SIGNATURE

​
Step 5: Submit to Marketplace

curl -X POST https://marketplace.argentos.ai/api/v1/publish \
  -H "Authorization: Bearer <your-author-token>" \
  -F "package=@aos-{name}.argent-pkg" \
  -F "manifest=$(cat argent.plugin.json)"
The marketplace server:
  1. Validates the manifest schema
  2. Verifies the Ed25519 signature against your registered public key
  3. Runs static analysis for malicious patterns
  4. Audits declared permissions
  5. Stores the package in the database + CDN
  6. Returns status: published, pending_review, or flagged

​
Step 6: Verify Your Listing

# Search the catalog
curl https://marketplace.argentos.ai/api/v1/catalog?q=aos-{name}

# Or via CLI
argent marketplace search {name}
Your connector should appear in the dashboard under Settings > Marketplace.

​
Installing from Marketplace

Users install your connector with: 
argent marketplace install aos-{name}
This downloads the package to ~/.argentos/connectors/aos-{name}/, verifies the signature and checksums, and makes it available to the agent on the next gateway restart.

​
Marketplace API Reference

MethodPathPurpose
GET/api/v1/catalogSearch packages (query, category, tags)
GET/api/v1/catalog/:idPackage details
GET/api/v1/catalog/:id/downloadSigned download URL
POST/api/v1/publishUpload new package/version
POST/api/v1/activateActivate a license key
GET/api/v1/license/:keyCheck license status

​
Version Updates

To publish an update:
  1. Bump the version in both argent.plugin.json and connector.json
  2. Rebuild the tarball
  3. Re-sign with your key
  4. Submit via the same /api/v1/publish endpoint
The marketplace handles versioning — users see the update in their dashboard and can upgrade with argent marketplace install aos-{name}.

​
Public Core Marketplace

Public Core (free) installations see the marketplace without a license gate. The catalog shows all free packages by default. Paid packages display pricing but require license activation to download.