Skip to content
Last updated

Libraries & SDKs

Official SDKs

Aitronos provides official Software Development Kits (SDKs) to simplify integration with the Freddy AI API across multiple programming languages.

Python SDK

The official Python library for Freddy AI with full async support and type hints.

pip install freddy-ai

Features:

  • ✅ Full API coverage (Responses, Files, Vector Stores, Images, Models)
  • ✅ Synchronous and asynchronous clients
  • ✅ Type hints and autocompletion
  • ✅ Comprehensive error handling
  • ✅ Context manager support

Quick Start:

from freddy import FreddyClient

# Sync client
with FreddyClient(api_key="your-api-key") as client:
    response = client.responses.create(
        model="gpt-4.1",
        inputs=[{"role": "user", "texts": [{"text": "Hello!"}]}]
    )
    print(response.output[0].content[0].text)

# Async client
from freddy import AsyncFreddyClient

async with AsyncFreddyClient(api_key="your-api-key") as client:
    response = await client.responses.create(
        model="gpt-4.1",
        inputs=[{"role": "user", "texts": [{"text": "Hello!"}]}]
    )
    print(response.output[0].content[0].text)

Documentation: Complete Python SDK Guide →

JavaScript/TypeScript SDK

Official Node.js and browser library for Freddy AI.

npm install @aitronos/freddy-ai
# or
yarn add @aitronos/freddy-ai

Features:

  • TypeScript support with full type definitions
  • Works in Node.js and modern browsers
  • Streaming and real-time APIs
  • Promise-based and async/await
  • Automatic request/response validation

Quick Start:

import { Freddy } from '@aitronos/freddy-ai';

const freddy = new Freddy({
  apiKey: process.env.FREDDY_API_KEY,
});

const response = await freddy.responses.create({
  model: 'freddy-1',
  messages: [
    { role: 'user', content: 'Hello, Freddy!' }
  ],
});

console.log(response.output);

Documentation: JavaScript SDK Docs 📝 Draft

.NET SDK

Official C# library for Freddy AI.

dotnet add package Aitronos.Freddy

Features:

  • .NET 6+ and .NET Framework support
  • Strongly typed models
  • Async/await patterns
  • Streaming support
  • Dependency injection friendly

Quick Start:

using Aitronos.Freddy;

var client = new FreddyClient("your_api_key");

var response = await client.Responses.CreateAsync(new CreateResponseRequest
{
    Model = "freddy-1",
    Messages = new[]
    {
        new Message { Role = "user", Content = "Hello, Freddy!" }
    }
});

Console.WriteLine(response.Output);

Documentation: .NET SDK Docs 📝 Draft

Community Libraries

The Freddy AI community has created libraries for additional languages and frameworks.

Go

freddy-go - Community-maintained Go client

go get github.com/community/freddy-go

GitHub Repository 📝 Draft

Ruby

freddy-ruby - Community-maintained Ruby gem

gem install freddy-ai

GitHub Repository 📝 Draft

Java

freddy-java - Community-maintained Java client

<dependency>
    <groupId>com.aitronos</groupId>
    <artifactId>freddy-java</artifactId>
    <version>1.0.0</version>
</dependency>

GitHub Repository 📝 Draft

PHP

freddy-php - Community-maintained PHP library

composer require aitronos/freddy-php

GitHub Repository 📝 Draft

Framework Integrations

LangChain

Freddy AI integrates seamlessly with LangChain for building LLM applications.

from langchain_freddy import FreddyLLM

llm = FreddyLLM(api_key="your_api_key", model="freddy-1")
response = llm.predict("Hello, Freddy!")

Documentation 📝 Draft

LlamaIndex

Use Freddy AI with LlamaIndex for data-augmented LLM applications.

from llama_index.llms import Freddy

llm = Freddy(api_key="your_api_key")

Documentation 📝 Draft

REST API Direct Usage

Don't want to use an SDK? You can make direct HTTP requests to the Freddy API from any language or tool.

cURL Example

curl https://api.freddy.aitronos.com/v1/responses \\
  -H "Authorization: Bearer YOUR_API_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{
    "model": "freddy-1",
    "messages": [
      {"role": "user", "content": "Hello, Freddy!"}
    ]
  }'

HTTP Clients

Any HTTP client library works with Freddy:

  • Python: requests, httpx, aiohttp
  • JavaScript: fetch, axios, node-fetch
  • Java: HttpClient, OkHttp, Apache HttpClient
  • C#: HttpClient
  • .NET: RestSharp, Flurl

See our API Reference for complete endpoint documentation.

Contributing

Want to contribute to an SDK or create a new library?

Support

Having issues with an SDK?

SDKs maintained by Aitronos and the Freddy AI community 🚀

Previous page
Next page