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.
npm install @git/client-sdk
# or
yarn add @git/client-sdk
# or
pnpm add @git/client-sdk
pip install git-sdk-python
# or
poetry add git-sdk-python
go get github.com/git-dev/sdk-go/v3
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.
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.
# 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.