SDKs and CLI

npm install @alguna/sdk

pip install alguna

go get github.com/alguna-io/alguna-go

cargo add alguna
cargo add tokio --features macros,rt-multi-thread

npm install --global @alguna/cli
alguna login

import { Alguna } from "@alguna/sdk";

// Reads the API key from ALGUNA_API_KEY when you do not pass apiKey.
const alguna = new Alguna({
  apiVersion: "2026-04-01", // recommended — pin the version you integrate against
});

from alguna import Alguna

# Reads the API key from ALGUNA_API_KEY when you do not pass api_key.
client = Alguna(
    api_version="2026-04-01",  # recommended: pin the version you integrate against
)

import (
	alguna "github.com/alguna-io/alguna-go"
	"github.com/alguna-io/alguna-go/client"
	"github.com/alguna-io/alguna-go/option"
)

// With no options, the client reads the API key from ALGUNA_API_KEY.
c := client.NewAlguna(
	option.WithAPIVersion("2026-04-01"), // recommended: pin the version you integrate against
)

use alguna::prelude::*;
use alguna::ApiClientBuilder;

fn client() -> Result<Alguna, ApiError> {
    // Reads the API key from ALGUNA_API_KEY when you do not call api_key.
    ApiClientBuilder::default()
        .api_version("2026-04-01") // recommended: pin the version you integrate against
        .build()
}

# A flag wins over an environment variable, and an environment variable wins over the key saved by login.
export ALGUNA_API_VERSION=2026-04-01
alguna version

const customer = await alguna.customers.create({
  name: "Acme Corp",
  currency: "USD",
  contacts: [{ email: "billing@acme.com", is_primary: true }],
});

from alguna import ContactRequest

customer = client.customers.create(
    name="Acme Corp",
    currency="USD",
    contacts=[ContactRequest(email="billing@acme.com", is_primary=True)],
)

ctx := context.Background()

customer, err := c.Customers.Create(ctx, &alguna.CreateCustomerRequest{
	Name:     "Acme Corp",
	Currency: "USD",
	Contacts: []*alguna.ContactRequest{
		{Email: "billing@acme.com", IsPrimary: true},
	},
})
if err != nil {
	return err
}

let customer = client
    .customers
    .create(
        &CreateCustomerRequest {
            name: "Acme Corp".to_string(),
            currency: "USD".to_string(),
            ..Default::default()
        },
        None,
    )
    .await?;

alguna customers create --name "Acme Corp" --currency USD
alguna customers list --limit 10