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):

Step 1: Create Package Manifest

Create argent.plugin.json in your connector directory:

Pricing Options

Revenue split for paid connectors: 70% creator / 30% ArgentOS. Payouts via Stripe Connect.

Step 2: Build the Tarball

Step 3: Generate Checksums

Step 4: Sign the Package

Sign with your Ed25519 private key:

Step 5: Submit to Marketplace

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

Your connector should appear in the dashboard under Settings > Marketplace.

Installing from Marketplace

Users install your connector with:
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

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.