​
Available SDKs

Our official SDKs provide type-safe, feature-rich integration with the Solvice optimization platform. Choose the SDK that matches your development stack.

TypeScript SDK

Full TypeScript support with modern runtime compatibility (Node.js, Deno, Bun, browsers)

Python SDK

Pythonic interface with async support and data science library integration

​
Why Use Our SDKs?

Our official SDKs provide significant advantages over direct REST API integration:

​
Developer Experience

  • Type Safety - Full type definitions prevent runtime errors and improve IDE support
  • Auto-completion - Rich IntelliSense and code completion for faster development
  • Built-in Validation - Client-side request validation catches errors before API calls

​
Reliability & Performance

  • Automatic Retries - Configurable retry logic for network resilience
  • Error Handling - Comprehensive error types with detailed debugging information
  • Connection Pooling - Efficient HTTP connection management for better performance

​
Advanced Features

  • Async Support - Native async/await patterns for non-blocking operations
  • Polling Utilities - Automatic status polling for long-running optimization jobs
  • Configuration Management - Centralized API key and timeout configuration

​
Quick Comparison

FeatureTypeScript SDKPython SDK
Installationnpm install solvice-vrp-solverpip install --pre solvice-vrp-solver
Type Safety✅ Full TypeScript support✅ Type hints and validation
Async Support✅ Native async/await✅ Both sync and async clients
Runtime SupportNode.js, Deno, Bun, BrowsersPython 3.8+
Error Handling✅ Typed error classes✅ Exception hierarchy
Auto Retry✅ Configurable✅ Configurable
Data IntegrationJSON/JavaScript objects✅ Pandas DataFrame support

​
Getting Started

Choose your preferred language to get started:
1

Select Your SDK

Pick the SDK that matches your development environment:
2

Install the Package

Use your package manager to install the SDK:
npm install solvice-vrp-solver
3

Get Your API Key

Obtain your API key from the Solvice dashboard and store it securely in environment variables.
4

Write Your First Integration

Follow the quick start guide for your chosen SDK to implement your first route optimization.

​
Migration from REST API

If you’re currently using direct REST API calls, migrating to our SDKs is straightforward:

​
Before (REST API)

// Manual HTTP requests with error handling
const response = await fetch('https://api.solvice.io/v2/vrp/solve', {
  method: 'POST',
  headers: {
    'Authorization': apiKey,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(request)
});

if (!response.ok) {
  throw new Error(`HTTP ${response.status}`);
}

const { jobId } = await response.json();

// Manual polling logic...
while (true) {
  const statusResponse = await fetch(`https://api.solvice.io/v2/vrp/jobs/${jobId}/status`);
  // ... polling implementation
}

​
After (SDK)

// Simple, type-safe SDK call
const client = new SolviceVrpSolver({ apiKey });
const solution = await client.vrp.syncSolve(request);
console.log(solution.routes);

​
Alternative Integration Methods

While we recommend using our official SDKs, you can also integrate using:

REST API

Direct HTTP requests to our RESTful endpoints

OpenAPI Spec

Generate client code from our OpenAPI specification

​
Community & Support

GitHub

View source code, report issues, and contribute

Support

Get help from our engineering team

API Reference

Complete API documentation and examples

​
Roadmap

We’re continuously improving our SDKs based on community feedback:

​
Coming Soon

  • Go SDK - Native Go library for backend services
  • Java SDK - Enterprise-ready Java library with Spring Boot integration
  • CLI Tool - Command-line interface for batch processing and automation

​
Enhanced Features

  • Webhook Support - Native webhook handling for job completion notifications
  • Batch Operations - Optimized APIs for processing multiple requests
  • Monitoring Integration - Built-in metrics and observability features
Interested in a specific language or feature? Contact us at sdk@solvice.io to share your requirements.