# 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.


```bash
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:**


```python
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 →](/docs/documentation/libraries/python-sdk)

### JavaScript/TypeScript SDK

Official Node.js and browser library for Freddy AI.


```bash
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:**


```typescript
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](https://github.com/aitronos/freddy-js) 📝 Draft

### .NET SDK

Official C# library for Freddy AI.


```bash
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:**


```csharp
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](https://github.com/aitronos/freddy-dotnet) 📝 Draft

## Community Libraries

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

### Go

**freddy-go** - Community-maintained Go client


```bash
go get github.com/community/freddy-go
```

[GitHub Repository](https://github.com/community/freddy-go) 📝 Draft

### Ruby

**freddy-ruby** - Community-maintained Ruby gem


```bash
gem install freddy-ai
```

[GitHub Repository](https://github.com/community/freddy-ruby) 📝 Draft

### Java

**freddy-java** - Community-maintained Java client


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

[GitHub Repository](https://github.com/community/freddy-java) 📝 Draft

### PHP

**freddy-php** - Community-maintained PHP library


```bash
composer require aitronos/freddy-php
```

[GitHub Repository](https://github.com/community/freddy-php) 📝 Draft

## Framework Integrations

### LangChain

Freddy AI integrates seamlessly with LangChain for building LLM applications.


```python
from langchain_freddy import FreddyLLM

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

[Documentation](https://python.langchain.com/docs/integrations/llms/freddy) 📝 Draft

### LlamaIndex

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


```python
from llama_index.llms import Freddy

llm = Freddy(api_key="your_api_key")
```

[Documentation](https://docs.llamaindex.ai/en/stable/examples/llm/freddy.html) 📝 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


```bash
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](/docs/api-reference/introduction) for complete endpoint documentation.

## Contributing

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

- 📖 **[Contribution Guidelines](https://github.com/aitronos/freddy-sdk-guidelines)** 📝 Draft
- 💬 **[Developer Community](https://community.aitronos.com)** 📝 Draft
- 📧 **Contact:** [developers@aitronos.com](mailto:developers@aitronos.com)


## Support

Having issues with an SDK?

- 🐛 **[Report SDK Issues](https://github.com/aitronos/freddy-sdk/issues)** 📝 Draft
- 💬 **[Community Forums](https://community.aitronos.com)** 📝 Draft
- 📧 **[Developer Support](mailto:support@aitronos.com)**


*SDKs maintained by Aitronos and the Freddy AI community* 🚀