​
Client Libraries

Tinfoil provides official libraries in multiple languages to help you integrate with our API:

LanguagePackage ManagerInstallationGitHub
Pythonpippip install tinfoiltinfoil-python
Node.jsnpmnpm install tinfoiltinfoil-node
SwiftSPMAdd to dependencies: .package(url: "https://github.com/tinfoilsh/tinfoil-swift", from: "1.0.0")tinfoil-swift
GoGo Modulesgo get github.com/tinfoilsh/tinfoil-gotinfoil-go

Each library provides a drop-in replacement for the OpenAI client libraries:

  • Python: TinfoilAI supports the same interface as the OpenAI Python client
  • Node.js: TinfoilAI supports the same interface as the OpenAI Node client
  • Swift: TinfoilKit supports the same interface as the OpenAIKit Swift client
  • Go: tinfoil supports the same interface as the openai Go client

​
Code Examples

​
Python

from tinfoil import TinfoilAI

client = TinfoilAI(
    enclave="models.default.tinfoil.sh",
    repo="tinfoilsh/default-models-nitro",
    api_key="<API_KEY>",
)

chat_completion = client.chat.completions.create(
    messages=[
        {
            "role": "user",
            "content": "Hi",
        }
    ],
    model="model-name",
)
print(chat_completion.choices[0].message.content)

​
Node.js

import { TinfoilAI } from "tinfoil";

const client = new TinfoilAI({
  enclave: "models.default.tinfoil.sh",
  repo: "tinfoilsh/default-models-nitro",
  apiKey: "<API_KEY>",
});

const completion = await client.chat.completions.create({
  messages: [{ role: "user", content: "Hello!" }],
  model: "model-name",
});

console.log(completion.choices[0].message.content);

​
Swift

import TinfoilKit

let client = TinfoilAI(
    apiKey: "<API_KEY>",
    enclave: "models.default.tinfoil.sh",
    repo: "tinfoilsh/default-models-nitro"
)

let completion = try await client.chat.completions.create(
    messages: [
        .user(content: "Hello!")
    ],
    model: "model-name"
)

print(completion.choices[0].message.content)

​
Go

import (
    "fmt"
    "github.com/tinfoilsh/tinfoil-go" // imported as tinfoil
)

client := tinfoil.NewSecureClient(
    "models.default.tinfoil.sh",
    "tinfoilsh/default-models-nitro",
)

chatCompletion, err := client.Chat.Completions.New(context.TODO(), openai.ChatCompletionNewParams{
    Messages: openai.F([]openai.ChatCompletionMessageParamUnion{
        openai.UserMessage("Say this is a test"),
    }),
    Model: openai.F("model-name"),
})

if err != nil {
    panic(err.Error())
}

fmt.Println(chatCompletion.Choices[0].Message.Content)

​
CLI

You can install the Tinfoil CLI using curl:

curl -fsSL https://github.com/tinfoilsh/tinfoil-cli/raw/main/install.sh | sh

Example usage:

$ tinfoil chat "Why is tinfoil now called aluminum foil?"