SDK Overview
Loopai provides production-ready client SDKs for .NET, Python, and TypeScript with consistent APIs and modern development patterns.
Available SDKs
.NET SDK
Package: Loopai.Client (NuGet)
Target: .NET 8.0+
License: MIT
dotnet add package Loopai.Client
Features:
- ASP.NET Core dependency injection
- Polly v8 retry policies
- IHttpClientFactory integration
- Comprehensive logging
Python SDK
Package: loopai (PyPI)
Requires: Python 3.9+
License: MIT
pip install loopai
Features:
- Full async/await support
- Pydantic v2 models
- Context manager support
- Type hints throughout
View Python SDK Documentation →
TypeScript SDK
Package: @loopai/sdk (npm)
Requires: Node.js 16+
License: MIT
npm install @loopai/sdk
Features:
- Full TypeScript types
- Promise-based async/await
- Node.js and browser support
- Tree-shakable modules
View TypeScript SDK Documentation →
Common Features
All SDKs share these capabilities:
✅ Core Operations
| Operation | Description | All SDKs |
|---|---|---|
| Task Creation | Create AI-powered tasks | ✅ |
| Task Execution | Execute tasks with input | ✅ |
| Batch Operations | Bulk processing | ✅ |
| Task Management | CRUD operations | ✅ |
| Error Handling | Comprehensive exceptions | ✅ |
✅ Advanced Features
| Feature | Description | .NET | Python | TypeScript |
|---|---|---|---|---|
| Async/Await | Modern async patterns | ✅ | ✅ | ✅ |
| Automatic Retry | Exponential backoff | ✅ | ✅ | ✅ |
| Type Safety | Strong typing | ✅ | ✅ | ✅ |
| Batch Concurrency | Concurrent execution | ✅ | ✅ | ✅ |
| DI Integration | Dependency injection | ✅ | ❌ | ❌ |
| Context Manager | Resource management | ❌ | ✅ | ❌ |
| Browser Support | Browser compatibility | ❌ | ❌ | ✅ |
✅ Quality Standards
| Metric | Target | Status |
|---|---|---|
| Test Coverage | >90% | ✅ 92-94% |
| Integration Tests | 14 per SDK | ✅ 42 total |
| Cross-SDK Compatibility | 100% | ✅ Verified |
| Documentation | Complete | ✅ All SDKs |
Quick Start Comparison
.NET
// Dependency Injection
builder.Services.AddLoopaiClient(options =>
{
options.BaseUrl = "http://localhost:8080";
});
// Usage
var result = await _loopai.ExecuteAsync(taskId, input);
Python
# Context Manager
async with LoopaiClient("http://localhost:8080") as client:
result = await client.execute(task_id, input_data)
TypeScript
// Promise-based
const client = new LoopaiClient({ baseUrl: 'http://localhost:8080' });
const result = await client.execute({ taskId, input });
Performance
All SDKs deliver consistent performance:
| SDK | Avg Response Time | Throughput (req/s) | Memory Usage |
|---|---|---|---|
| .NET | 45.2ms | 34.6 | 62 MB avg |
| Python | 43.8ms | 35.1 | 52 MB avg |
| TypeScript | 44.5ms | 34.2 | 58 MB avg |
Installation Guides
.NET
# NuGet Package Manager
Install-Package Loopai.Client
# .NET CLI
dotnet add package Loopai.Client
# Package Reference
<PackageReference Include="Loopai.Client" Version="0.1.0" />
Python
# pip
pip install loopai
# poetry
poetry add loopai
# requirements.txt
loopai==0.1.0
TypeScript
# npm
npm install @loopai/sdk
# yarn
yarn add @loopai/sdk
# pnpm
pnpm add @loopai/sdk
Examples
Each SDK includes comprehensive examples:
- Basic Usage: Task creation and execution
- Batch Processing: Bulk operations with concurrency
- Error Handling: Exception handling patterns
Browse SDK-specific examples:
SDK Roadmap
Coming Soon
-
Go SDK (Phase 12.2)
- Native Go client
- Context support
- goroutine-safe
-
Streaming API (Phase 12.1)
- Real-time results
- Server-Sent Events
- Available in all SDKs
Under Consideration
- Java SDK
- Ruby SDK
- Rust SDK
- PHP SDK
Support
- Documentation: SDK-specific guides
- Examples: Working code samples
- GitHub: Issues and Discussions
- Integration Tests: Test Results
Next Steps
Choose your SDK and start building:
- .NET SDK Guide - For .NET applications
- Python SDK Guide - For Python applications
- TypeScript SDK Guide - For JavaScript/TypeScript applications