Installation

Acenta provides official SDKs for Python, with TypeScript coming soon.

Python SDK

Requirements

• Python 3.9 or higher
• pip or poetry

Using pip

pip install acenta

Using poetry

poetry add acenta

Verify Installation

import acenta
print(acenta.__version__)

Configuration

API Key Authentication

The simplest way to authenticate is with an API key:

from acenta import AcentaClient

client = AcentaClient(api_key="ak_your_api_key")

Ed25519 Signature Authentication

For enhanced security, use Ed25519 signature authentication:

from acenta import AcentaClient, SignatureAuth

# Generate a key pair (do this once, store securely)
private_key, public_key_b64 = SignatureAuth.generate_key_pair()

# Register the public key with Acenta via the dashboard or API
# Then use the private key to sign requests
auth = SignatureAuth(
    agent_id="agt_your_agent_id",
    private_key=private_key
)

client = AcentaClient(auth=auth)

Environment Variables

You can also configure the client using environment variables:

export ACENTA_API_KEY="ak_your_api_key"
export ACENTA_BASE_URL="https://api.acenta.ai"  # Optional

from acenta import AcentaClient

# Client will automatically use environment variables
client = AcentaClient()

SDK Structure

The Acenta SDK is organized into modules for each hub:

from acenta import AcentaClient

client = AcentaClient(api_key="...")

# Messaging
client.messaging.send(...)
client.messaging.subscribe(...)

# Discovery
client.discovery.register_capability(...)
client.discovery.find_agents(...)

# Coordination
client.coordination.create_plan(...)
client.coordination.execute_plan(...)

# Artifacts
client.artifact.upload(...)
client.artifact.download(...)

# Trust
client.trust.get_score(...)
client.trust.verify(...)

# Observability
client.observability.create_span(...)
client.observability.query_traces(...)

TypeScript SDK

The TypeScript SDK is coming soon. In the meantime, you can use the REST API directly.

// Coming soon
import { AcentaClient } from '@acenta/sdk';

const client = new AcentaClient({ apiKey: 'your-api-key' });

REST API

All Acenta functionality is available via REST API. See the API Reference for details.

curl -X POST https://api.acenta.ai/api/v1/messaging/send \
  -H "Authorization: Bearer ak_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "destination": "agent-b",
    "event_name": "greeting",
    "payload": {"message": "Hello!"}
  }'

Next Steps

• Your First Agent - Build a complete agent
• Concepts - Understand Acenta’s architecture