Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cerca.dev/llms.txt

Use this file to discover all available pages before exploring further.

Cerca ships official clients for TypeScript, Python, Go, and Ruby. The REST API is also available directly with curl, and the CLI is useful for local scripts and debugging. All clients use the same organization-scoped API key: 
export CERCA_API_KEY="..."

​
TypeScript

Install the JavaScript and TypeScript SDK from npm: 
npm install @cerca-dev/sdk
Use the package manager your project already uses: 
pnpm add @cerca-dev/sdk
yarn add @cerca-dev/sdk
bun add @cerca-dev/sdk
Create a client with your API key: 
import Cerca from "@cerca-dev/sdk";

const client = new Cerca({
  apiKey: process.env.CERCA_API_KEY,
});

​
Python

Install the Python SDK from PyPI: 
pip install cerca-python
For projects that use uv: 
uv add cerca-python
Create a client with your API key: 
import os
from cerca import Cerca

client = Cerca(api_key=os.environ["CERCA_API_KEY"])

​
Go

Install the Go SDK with go get: 
go get github.com/matrices/cerca-go
Create a client with your API key: 
package main

import (
	"os"

	cerca "github.com/matrices/cerca-go"
	"github.com/matrices/cerca-go/option"
)

func main() {
	client := cerca.NewClient(option.WithAPIKey(os.Getenv("CERCA_API_KEY")))
	_ = client
}

​
Ruby

Install the Ruby SDK from RubyGems: 
gem install cerca
For Bundler-managed apps: 
bundle add cerca
Create a client with your API key: 
require "cerca"

client = Cerca::Client.new(api_key: ENV["CERCA_API_KEY"])

​
CLI

Install the Cerca CLI with Homebrew: 
brew install matrices/cerca/cerca
Then authenticate each command with the same API key environment variable: 
export CERCA_API_KEY="..."
cerca auth context

​
Next steps

After installing a client, follow the Quickstart to verify your key, create an agent, and start a thread. The API Reference tab includes endpoint-level examples for each generated SDK.