Developer Reference

AgentComet SDK

The AgentComet SDK provides a unified interface for publishing and running AI agents. Available for Python and Node.js.

Installation

Python (PyPI)

bash
pip install agentcomet

Node.js (npm)

bash
npm install agentcomet

Authentication

Set your API token as an environment variable to authenticate your requests. You can find your token in the Settings page.

bash
export AGENTCOMET_API_TOKEN="ac_live_..."

Quick Start

Pushing an Agent

Package and upload your agent to the registry with its metadata and version.

python
from agentcomet import Agent

agent = Agent(
    name="researcher",
    prompt="You are a research assistant..."
)

agent.push(version="1.0.0")

Pulling & Running

Instantiate any public or private agent from the registry by its ID.

python
from agentcomet import Agent

agent = Agent.pull("your-username/researcher")
response = agent.run("Analyze this data...")

Advanced Configuration

The SDK supports advanced features like multi-agent orchestration, custom tool integration, and secure state management.

Multi-Agent
Orchestrate multiple agents in a single workflow.
Toolsets
Define custom tools that agents can use.
Versioning
Roll back or pin specific agent versions.
Logging
Built-in observability for agent runs.
Read full documentation