Client SDKs

Integrate .git into your applications with our officially maintained client libraries. Built for performance, type safety, and developer experience.

Note: All SDKs are open-source and follow semantic versioning. The latest stable release is v3.2.0. Upgrade guides are available in the Changelog.

Installation

Install the SDK for your preferred language using your package manager of choice.

Terminal
npm install @git/client-sdk
# or
yarn add @git/client-sdk
# or
pnpm add @git/client-sdk
Terminal
pip install git-sdk-python
# or
poetry add git-sdk-python
Terminal
go get github.com/git-dev/sdk-go/v3
Terminal
npm install @git/sdk-ts
# Full type definitions included

Quick Start

Initialize the client with your API key and start interacting with the .git platform immediately.

JavaScript / Node.js
import { GitClient } from '@git/client-sdk';

// Initialize with your API key
const git = new GitClient({
  apiKey: process.env.GIT_API_KEY,
  environment: 'production',
  timeout: 5000
});

// Fetch repositories
async function listRepos() {
  const repos = await git.repositories.list({
    limit: 10,
    sort: 'updated'
  });
  
  console.log(`Found ${repos.total} repositories`);
  return repos;
}

listRepos();

Supported Languages & Platforms

Our SDKs are officially maintained and tested against the latest LTS versions of each runtime.

Language Package Version Status Docs
JavaScript / Node.js @git/client-sdk v3.2.0 Stable Reference
TypeScript @git/sdk-ts v3.2.0 Stable Reference
Python git-sdk-python v3.1.4 Stable Reference
Go github.com/git-dev/sdk-go v3.0.2 Beta Reference
Rust git-sdk v0.8.1 Beta Reference

Configuration & Environment

The SDK supports multiple configuration methods. We recommend using environment variables for API keys and sensitive credentials.

.env.example
# Required
GIT_API_KEY=sk_live_...
GIT_ORG_ID=org_123...

# Optional
GIT_ENVIRONMENT=staging
GIT_TIMEOUT_MS=10000
GIT_RETRY_COUNT=3

Advanced Configuration

Override defaults per-request or globally using the configuration builder pattern available in all SDKs.

Security Best Practice: Never hardcode API keys. Use your platform's secret management system or environment variables. Keys should rotate every 90 days.

"}